用途：在授权渗透测试中，用 Shodan 系统化开展侦察。覆盖 Web 界面、命令行（CLI）、REST API、搜索过滤器、按需扫描与网络监控，用于发现暴露服务、脆弱系统与 IoT 设备。产出可包括资产清单、漏洞报告、服务 banner、网络映射、截图与 JSON/CSV 导出数据。
前置条件：shodan.io 免费或付费账户、账户面板获取的 API Key、目标 IP/域名/网段、Python 版 Shodan CLI，以及对目标网络的书面授权。
使用方式：安装 CLI 可用 pip install shodan、easy_install shodan 或 sudo pacman -S python-shodan。用 shodan init YOUR_API_KEY 初始化，shodan info 验证，shodan myip 查外网 IP，shodan version 查版本。单主机查询用 shodan host IP，蜜罐检测用 shodan honeyscore IP。搜索用 shodan search 查询、shodan count 计数、shodan download 文件 查询 下载、shodan parse 提取字段、shodan stats 统计。按需扫描用 shodan scan submit IP，shodan scan list 与 shodan scan status SCAN_ID 跟踪。也可直接调用 REST API 或 Python 库。
过滤器示例：ip、net、hostname、port、asn；country、city、state、postal、geo；org、isp；product、version、os、http.title、http.html、http.status、ssl 相关；vuln:CVE-XXXX、has_vuln；has_screenshot、screenshot.label。
限制：速率约 1 请求/秒；扫描结果为异步，非即时；非企业版 24 小时内不可重复扫描同一 IP；免费账户额度有限，部分数据需付费；数据可能滞后数天到数周。仅可对获授权目标侦察，主动扫描需授权，被动侦察也需确认辖区法律并留存记录。