Hunter API 批量查询工具

本项目是一个用于批量查询 奇安信 Hunter API 的 Python 工具，支持自动分页、积分检查、断点续查、Excel 报告导出和结果去重。

特性

• 支持批量域名后缀查询，自动分页抓取近一年资产数据
• 自动积分检查与重试机制
• 结果导出为 Excel（hunter_results.xlsx），并生成 IP、域名、端口等文本文件
• 支持跳过大资产量域名
• 结果自动去重
• 详细日志记录

安装依赖

pip install -r requirements.txt

使用方法

1. 配置 API Key

   运行程序后会自动生成 config.json，请将 your_api_key_here 替换为你的 Hunter API Key。

2. 准备域名后缀列表

   编辑 domains.txt，每行一个域名后缀，例如：

   example.com
   test.org
   

3. 运行程序

   python main.py

   可选参数：

   • -c/--config 配置文件路径（默认：config.json）
   • -d/--domains 域名后缀列表文件路径（默认：domains.txt）
   • -o/--output 输出目录（默认：output）
   • -p/--pages 每个域名最大查询页数（默认：3）
   • -s/--size 每页资产数量（默认：100，最大100）
   • -m/--max 单域名最大资产总数（默认：300）
   • --delay 初始API请求延迟（秒，默认：2.0）
   • --retries API请求最大重试次数（默认：3）

   例如：

   python main.py -d mydomains.txt -o result_dir --pages 5 --max 500

输出说明

• output/hunter_results.xlsx：所有资产的详细 Excel 报告
• output/ip.txt：所有发现的 IP
• output/domain.txt：所有发现的子域名/主机名
• output/socketnurl.txt：所有 IP:端口 和 URL
• output/process.log：详细日志
• output/progress_status.json：进度状态
• output/skip.txt：被跳过的域名后缀
• output/resume.txt：已处理完成的域名后缀

注意事项

• 仅支持 Hunter API v2/v3，需自行申请 API Key
• 查询时间范围固定为近一年
• 若积分不足或资产量过大，程序会自动跳过或终止
• 结果文件自动去重
• Claude is a good friend of humanity
• 若存在问题请反馈