Urlscan.Io api wrapper
urlscan-p的Python项目详细描述
##urlscan py
说明：
urlscan py是urlscan.io用来扫描URL的API的Python包装器。
安装和使用：
通过PYPI:
pip3 install --user urlscan-py
保存api密钥：
API密钥将存储在默认数据库中，该数据库存储所有启动的扫描结果。默认情况下，此数据库位于~/.urlscan/urlscan.db。
要将api密钥保存到本地数据库，请使用init命令：
urlscan init --api xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
如果输入的api密钥不正确，或者发生了数据库中api密钥值不正确的其他错误，请尝试使用上述in it命令覆盖它，或者使用以下命令删除数据库文件：rm ~/.urlscan/urlscan.db。
扫描：
urlscan scan --url https://google.com
结果输出将生成一个uuid。检索扫描结果需要UUID。输出还将指示扫描是否已成功启动。
--url标志一次可以接受多个url。
将扫描队列uuid结果保存到不同的数据库文件：
urlscan scan --url https://google.com --db mydatabase.db
这将允许用户轻松查看sqlite3数据库中先前排队扫描的uuid。如果没有指定其他数据库文件，则默认为名为$HOME/.urlscan/urlscan.db的文件。
扫描存储在“example domains.txt”文件中的多个域
urlscan scan --url * --file 'example-domains.txt'
每个域都应该存储在一个文件中，每个域用换行符分隔。
扫描命令帮助：
❯ urlscan scan --help
usage: urlscan scan [-h] [--url URL [URL ...]] [--db FILE] [-f FILE] [-q]
[--api KEY]
optional arguments:
-h, --help show this help message and exit
--url URL [URL ...] URL(s) to scan
--db FILE specify different database file initiated scans will
be saved to
-f FILE, --file FILE file with url(s) to scan
-q, --quiet suppress output
--api KEY urlscan API key
搜索排队或先前完成的扫描
在本地数据库中搜索以前的扫描（必须与提交的URL匹配）：
urlscan search --url https://google.com
在urlscan.io中搜索域上的公共扫描：
urlscan search --url https://google.com --web
搜索命令帮助：
❯ urlscan search --help
usage: urlscan search [-h] [--url HOST [HOST ...]] [--db FILE] [--web]
optional arguments:
-h, --help show this help message and exit
--url HOST [HOST ...]
url(s) to search for matching UUID
--db FILE specify different database file to search
--web search urlscan.io for URL (public)
检索扫描结果：
urlscan retrieve --uuid UUID
这将把带有相关uuid的扫描打印到stdout。--uuid标志一次可以接受多个uuid。
将检索到的结果保存到特定目录：
urlscan retrieve --uuid UUID --dir DIRECTORY
默认情况下，扫描将保存到目录.urlsaved_scans。通过使用--dir标志并指定其他目录来更改此设置。
保存截图文件：
urlscan retrieve --uuid UUID --png
下载的截图png将存储在默认的--dir目录中，即~/.urlscan/saved_scans。指定不同的--dir位置以将PNG保存到另一个目录。
保存dom文件：
urlscan retrieve --uuid UUID --dom
下载的dom文件将存储在默认的--dir目录中，即~/.urlscan/saved_scans。指定不同的--dir位置以将dom文件保存到另一个目录。
检索命令帮助：
urlscan retrieve --help
❯ usage: urlscan retrieve [-h] --uuid UUID [UUID ...] [--db FILE] [--api KEY]
[-d DIRECTORY] [--dom] [--png] [-q]
optional arguments:
-h, --help show this help message and exit
--uuid UUID [UUID ...]
UUID(s) to retrieve scans for
--db FILE specify different database file to query
--api KEY urlscan API key
-d DIRECTORY, --dir DIRECTORY
directory to save scans to
--dom save dom file from retrieved result
--png save screenshot as png
-q, --quiet suppress output
作者：斯宾塞·海伍德
电子邮件：l.spencer.heywood@protonmail.com
欢迎加入QQ群-->： 979659372
