Hunter API 批量查询工具

一个基于 Hunter API 的资产批量查询工具，支持单个查询、企业名称批量查询、域名批量查询，并自动导出结果到 Excel/CSV。

功能特性

🎯 核心功能

• 单个查询模式：手动输入搜索语法进行精确查询
• 企业名称批量查询：自动构建 icp.name="企业名称" 语法批量查询企业资产
• 域名批量查询：自动构建 domain="域名" 语法批量查询域名资产
• 多 API Key 轮询：自动切换多个 Key，充分利用每个 Key 的积分额度
• 自动翻页导出：批量查询时自动获取所有数据并导出
• 实时进度显示：查询过程中实时显示日志和进度条

📊 数据导出

• Excel 格式：每个企业/域名保存为独立的 sheet 页（需要安装 openpyxl）
• CSV 格式：所有数据保存到单个 CSV 文件
• 界面同步显示：查询结果实时显示在程序界面表格中

🎨 界面功能

• API Key 余额查询：一键查询所有 Key 的积分余额
• 手动翻页：支持上一页/下一页手动浏览
• 右键复制：支持复制 IP、域名、URL 等字段
• 进度条显示：批量导出时显示实时进度

环境要求

• Python 3.7+
• Windows 系统（推荐）

安装依赖

pip install requests
pip install openpyxl  # 可选，用于Excel格式导出

或使用 requirements.txt：

pip install -r requirements.txt

配置说明

1. 创建 API Key 文件

在程序同级目录下创建 key.txt 文件，一行一个写入 Hunter API Key。

key.txt 示例：

36ee8b5fxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
db65e7afxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
28d6febaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

💡 如何获取 Hunter API Key？

• 访问 Hunter 官网
• 注册账号并登录
• 进入个人中心获取 API Key

2. 批量查询列表文件

企业名称批量查询

创建 companies.txt，一行一个企业全称：

北京百度网讯有限公司
腾讯科技（深圳）有限公司
阿里巴巴（中国）有限公司
字节跳动科技有限公司

⚠️ 注意：必须输入完整的企业名称，使用精确匹配语法

域名批量查询

创建 domains.txt，一行一个域名：

baidu.com
qq.com
taobao.com
jd.com

使用说明

单个查询模式

1. 选择查询模式为 "单个查询"
2. 输入 Hunter 搜索语法，例如：
   • web.body="xxxxxx" - 搜索网页内容
   • ip="1.1.1.1" - 搜索 IP 地址
   • port="80" - 搜索端口
   • protocol="http" - 搜索协议
3. 设置页码、每页条数、资产类型、时间范围（可选）
4. 点击 "开始查询数据"
5. 查看结果后，可通过 "上一页/下一页" 按钮手动翻页
6. 点击 "导出结果(CSV)" 保存当前结果

企业名称批量查询

1. 选择查询模式为 "企业名称批量"
2. 点击 "导入列表" 选择 companies.txt 文件
3. 点击 "选择保存目录" 设置结果保存位置
4. 点击 "开始批量查询"
5. 等待查询完成，结果自动保存为 Excel 文件

搜索语法示例：

• 输入：北京百度网讯有限公司
• 自动构建：icp.name="北京百度网讯有限公司"

域名批量查询

1. 选择查询模式为 "域名批量"
2. 点击 "导入列表" 选择 domains.txt 文件
3. 点击 "选择保存目录" 设置结果保存位置
4. 点击 "开始批量查询"
5. 等待查询完成，结果自动保存为 Excel 文件

搜索语法示例：

• 输入：baidu.com
• 自动构建：domain="baidu.com"

全部导出（多 Key）

1. 输入搜索语法
2. 点击 "全部导出(多Key)"
3. 选择保存位置
4. 自动使用所有 Key 的积分导出所有数据

输出字段

查询结果包含以下字段：

字段	说明
查询项	批量查询时显示企业名称或域名
IP	IP 地址
PORT	端口号
DOMAIN	域名
WEB_TITLE	网页标题
COUNTRY	国家
PROVINCE	省份
CITY	城市
STATUS_CODE	HTTP 状态码
OS	操作系统
COMPANY	公司名称
URL	完整 URL

高级功能

手动翻页

单个查询模式下，可通过界面上的翻页按钮手动浏览：

• 上一页：查看上一页结果
• 下一页：查看下一页结果
• 页码显示：当前页码/总结果数

右键菜单

在结果表格中右键单击行，可快速复制：

• 复制：复制整行数据
• 复制 IP：仅复制 IP 地址
• 复制 Domain：仅复制域名
• 复制 URL：复制完整 URL
• 复制整行：复制制表符分隔的整行数据

余额查询

点击 "查询所有 Key 余额" 可查看所有 Key 的积分情况：

• 免费积分
• 权益积分
• 总计积分

注意事项

1. API Key 配置：确保 key.txt 文件在程序同级目录，每行一个 Key
2. 企业名称：必须输入完整的企业名称，否则可能查询不到结果
3. 积分消耗：每查询 1 条数据消耗 1 积分，建议先查询余额
4. 请求频率：程序已内置请求间隔，避免触发风控
5. 网络连接：确保网络连接正常，能够访问 Hunter API

常见问题

Q1: 程序无法启动？

A: 检查是否安装了依赖：

pip install requests tkinter

Q2: 提示"未找到key.txt文件"？

A: 确保 key.txt 文件在程序同级目录，且每行一个 API Key

Q3: 批量查询不到结果？

A: 企业名称必须是完整名称，尝试使用精确的企业全称

Q4: Excel 导出失败？

A: 安装 openpyxl 库：

pip install openpyxl

Q5: 如何查看 Hunter API 余额？

A: 点击界面上的 "查询所有 Key 余额" 按钮

技术支持

• Hunter API 文档：https://hunter.qianxin.com/docs/api
• 问题反馈：提交 Issue 到项目仓库

更新日志

v1.0.0

• ✅ 支持单个查询、企业批量、域名批量三种模式
• ✅ 多 API Key 自动轮询
• ✅ Excel/CSV 双格式导出
• ✅ 实时进度显示和日志
• ✅ 右键快速复制功能

许可证

本项目仅供学习和研究使用，请遵守 Hunter API 使用条款。

---

开发者: B1nbya 项目地址: Hunter API 批量查询工具 最后更新: 2026-01-23