使用urlscan.io的API获取网站信息的命令行实用程序。
urlscanio的Python项目详细描述
urlscanio
摘要
URLScan.io是从潜在恶意网站扫描和获取信息的有用工具。urlscan的创建者已经非常有帮助地创建了一个API,它可以用来为您的工作流添加一些自动化功能。urlscanio
是一个简单的python cli实用程序,在使用urlscan时,它使用前面提到的api自动化我自己的个人工作流。
要求
urlscanio
是用python 3.7编写的,目前要求用户使用python>;=3.5,这主要是因为它使用了typing
模块。
安装
如果安装了兼容的python版本,只需运行(必要时使用pip3
):
pip install urlscanio
如何使用
在本节中,将概述cli的不同功能。您也可以使用urlscanio -h|--help
来获取终端内的信息。
API密钥和下载目录
此工具要求将名为URLSCAN_API_KEY
的环境变量设置为API密钥。或者,您也可以设置一个名为URLSCAN_DATA_DIR
的环境变量来指定屏幕截图和dom的下载位置。如果未设置,它们将被下载到运行脚本的目录中。
建议对此使用.bashrc
或.zshrc
文件。如果使用powershell,请将环境变量添加到用户配置文件中。
调查url
提供一个url(至少包含协议和域),将请求扫描并下载相应的截图和dom以及报告url。
示例:
urlscan -i https://www.amazon.co.uk urlscan --investigate http://some-dodgy.website
提交扫描请求
如果url(至少包含协议和域)将请求扫描并返回生成的uuid。这可以用来确定例如屏幕截图的位置。
示例:
urlscan -s https://www.amazon.co.uk urlscan --submit http://some-dodgy.website
检索扫描信息
如果uuid链接到所讨论的扫描,则将查询api以从报表中下载屏幕截图和dom,并返回报表url。
urlscan -r c5be1459-0a64-4751-bf25-8dd6d3c5742d urlscan --retrieve c5be1459-0a64-4751-bf25-8dd6d3c5742d