{
    "info": {
        "author": "Arthur Verkaik",
        "author_email": "art.v412@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 3 - Alpha",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3.5",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7",
            "Programming Language :: Python :: Implementation :: CPython"
        ],
        "description": "# urlscanio\n\n## Summary\n\n[URLScan.io][urlscan-homepage] is a useful tool for scanning and obtaining information from potentially malicious websites. The creators of URLScan have very helpfully made an [API][urlscan-api] which can be used to add some automation to your workflow. `urlscanio` is a simple Python CLI utility which makes use of the aforementioned APIs to automate my own personal workflow when it comes to using URLScan.\n\n## Requirements\n\n`urlscanio` was written in Python 3.7 and currently requires the user to have Python >= 3.5, mostly due to the fact that it makes use of the `typing` module.\n\n\n## Installation\n\nIf you have a compatible Python version installed, simply run (using `pip3` if necessary):\n\n```bash\npip install urlscanio\n```\n\n## How to use\n\nIn this section, the different functions of the CLI are outlined. You may also use `urlscanio -h|--help` for information within your terminal.\n\n### API key and download directory\n\nThis tool requires an environment variable named `URLSCAN_API_KEY` to be set to your API key. Optionally, you may also set an environment variable called `URLSCAN_DATA_DIR` to specify where the screenshots and DOM should be downloaded. If not set, they will be downloaded in the directory you run the script from.\n\nIt is recommended to use the `.bashrc` or `.zshrc` file for this. If using PowerShell, add the environment variables to your user profile.\n\n### Investigate URL\n\nProvided a URL (containing the protocol and domain at minimum), will request a scan and download the corresponding screenshot and DOM, as well as the report URL.\n\nExamples:\n\n```bash\nurlscan -i https://www.amazon.co.uk\nurlscan --investigate http://some-dodgy.website\n```\n\n### Submit scan request\n\nProvided a URL (containing the protocol and domain at minimum), will request a scan and return the UUID generated. This can then be used to determine eg the screenshot location.\n\nExamples:\n\n```bash\nurlscan -s https://www.amazon.co.uk\nurlscan --submit http://some-dodgy.website\n```\n\n### Retrieve scan information\n\nProvided the UUID linked to the scan in question, will query the API to download the screenshot and DOM from the report, as well as return the report URL.\n\n```bash\nurlscan -r c5be1459-0a64-4751-bf25-8dd6d3c5742d\nurlscan --retrieve c5be1459-0a64-4751-bf25-8dd6d3c5742d\n```\n\n[urlscan-homepage]: https://urlscan.io\n[urlscan-api]: https://urlscan.io/about-api/",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/Aquarthur/urlscanio",
        "keywords": "urlscan cli",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "urlscanio",
        "package_url": "https://pypi.org/project/urlscanio/",
        "platform": "",
        "project_url": "https://pypi.org/project/urlscanio/",
        "project_urls": {
            "Homepage": "https://github.com/Aquarthur/urlscanio"
        },
        "release_url": "https://pypi.org/project/urlscanio/0.0.5/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Command line utility to get information about a website using URLScan.io's APIs.",
        "version": "0.0.5"
    },
    "last_serial": 5588583,
    "releases": {
        "0.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "364369608675c8552094fb6f1891c92d",
                    "sha256": "6227ad3392539b8a88002f93c3faed28f8b9036735803e897efebbce671ef9a6"
                },
                "downloads": -1,
                "filename": "urlscanio-0.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "364369608675c8552094fb6f1891c92d",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 2748,
                "upload_time": "2018-08-05T22:16:14",
                "url": "https://files.pythonhosted.org/packages/69/7d/ad58c047f2c67437a1182c7b40e0b7cd1ef49fa8dc60854545075e2e5a14/urlscanio-0.0.2.tar.gz"
            }
        ],
        "0.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "bb8764c3d940ffecdaea1a1d3d9f6bb3",
                    "sha256": "2bc020251d094e3b1a9b35c41fd9235b94f72e505fc54a1e86fdef7b6037203a"
                },
                "downloads": -1,
                "filename": "urlscanio-0.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "bb8764c3d940ffecdaea1a1d3d9f6bb3",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 2766,
                "upload_time": "2018-08-05T22:20:58",
                "url": "https://files.pythonhosted.org/packages/a8/a7/6657efa2cac046a8413538a16a71aa9ada01b10a26379f50580697d46d72/urlscanio-0.0.3.tar.gz"
            }
        ],
        "0.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "8812526d18eadfb109fe7a8318f46193",
                    "sha256": "f5a8fed44a049b9759249aa6b291a0e3765bace2faf3894f55d8324e1c6c015d"
                },
                "downloads": -1,
                "filename": "urlscanio-0.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "8812526d18eadfb109fe7a8318f46193",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 2760,
                "upload_time": "2019-02-17T17:44:09",
                "url": "https://files.pythonhosted.org/packages/83/68/6f051c754fcc0e4e33b2cdf1b980478584f9f42d21010f28d0916d26572f/urlscanio-0.0.4.tar.gz"
            }
        ],
        "0.0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f3957fb65a46e7db6ca9efde6fe6bf80",
                    "sha256": "1e05091592f01c2e6c5869a76c49122f02c4acc0ffab5f6ef392450810edd4cd"
                },
                "downloads": -1,
                "filename": "urlscanio-0.0.5.tar.gz",
                "has_sig": false,
                "md5_digest": "f3957fb65a46e7db6ca9efde6fe6bf80",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5137,
                "upload_time": "2019-07-26T11:31:01",
                "url": "https://files.pythonhosted.org/packages/aa/71/7792efcab6219f8f73afc973987196243cbdb7e987816fc9a9d651d4adc0/urlscanio-0.0.5.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "f3957fb65a46e7db6ca9efde6fe6bf80",
                "sha256": "1e05091592f01c2e6c5869a76c49122f02c4acc0ffab5f6ef392450810edd4cd"
            },
            "downloads": -1,
            "filename": "urlscanio-0.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "f3957fb65a46e7db6ca9efde6fe6bf80",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 5137,
            "upload_time": "2019-07-26T11:31:01",
            "url": "https://files.pythonhosted.org/packages/aa/71/7792efcab6219f8f73afc973987196243cbdb7e987816fc9a9d651d4adc0/urlscanio-0.0.5.tar.gz"
        }
    ]
}