🔍 Qianxin Hunter Api#

本工具集成奇安信 Hunter 平台的 查询接口 和 导出任务（ 批量查询），可通过命令行处理：语法查询、提交导出（批量查询）任务、查询导出进度、下载导出文件。

📦 依赖#

• Python 3.10+
• Python Package requests
• 需配置环境变量

bash

QIANXIN_HUNTER_API_KEY="XXXXX"

🚀 核心功能用例#

1. 查询接口#

适用于快速检索小批量数据分页获取，直接在终端查看结果。

bash

# 仅指定查询语法，其他参数默认（默认获取第1页数据）
python3 scripts/query.py --search 'web.title="login"'

# 指定查询语法，其他可选参数：分页参数、时间范围、返回字段、资产类型（is_web）
python3 scripts/query.py --search 'app="OpenClaw"' --page 1 --page_size 10 --start '2026-01-01' --end '2026-03-01' --fields 'ip,port,domain' --is_web 1

2. 导出任务（批量查询）#

适用于大规模资产导出，也适用于批量ip/domain/company目标查询导出，导出结果通过csv文件形式下载。

第一步：提交任务 ( submit)

支持通过 语法 或 本地 CSV 文件 提交。

• 语法方式： bash

  # 仅指定查询语法进行导出，其他参数默认（默认返回可导出的全部数据）
  python3 scripts/query.py submit --search 'ip="1.1.1.1/24" && ip.port="80"'
  
  # 指定查询语法进行导出，其他可选参数：最大返回的资产数、时间范围、返回字段、资产类型（is_web）
  python3 scripts/query.py submit --search 'ip="1.1.1.1/24" && ip.port="80"' --limit 500 --start '2026-01-01' --end '2026-03-01' --fields 'ip,port,domain' --is_web 1
  
  

• 文件方式（需符合官方模板）： bash

  # 指定本地csv文件进行导出，文件类型默认为all（可以是ip、domain和company混合的文件）
  python3 scripts/query.py submit --file targets.csv
  
  # 指定本地csv文件进行导出，文件类型为ip
  python3 scripts/query.py submit --file targets.csv --type ip
  
  # 指定本地csv文件进行导出，文件类型为domain，其他可选参数：最大返回的资产数、时间范围、返回字段、资产类型（is_web）
  python3 scripts/query.py submit --file targets.csv --type domain --limit 500 --start '2026-01-01' --end '2026-03-01' --fields 'ip,port,domain' --is_web 1
  
  

第二步：查看进度 ( status)

使用提交任务返回的 task_id 追踪状态。

bash

python3 scripts/query.py batch status --task_id 1234

第三步：下载结果 ( download)

当状态显示为“已完成”时，下载导出的 CSV 文件。

bash

# 仅指定task_id，不指定保存文件名，默认保存文件名为 results_{task_id}.csv
python3 scripts/query.py batch download --task_id 1234

# 指定task_id，指定保存文件名
python3 scripts/query.py batch download --task_id 1234 --output results.csv

---

📋 参数速查表#

全局子命令#

• search: 查询模式。
• batch: 批量导出模式（含 submit, status, download 动作）。

查询参数#

长参数说明--searchHunter 查询语法（原始字符串），用于即时查询或批量查询/导出任务--page页码，默认 1``--page_size每页条数，默认 10``--start开始时间 (格式: 2021-01-01)--end结束时间 (格式: 2021-03-01)--is_web资产类型： 1 (Web), 2 (非Web), 3 (全部)，默认为全部。--fields返回字段，以逗号分隔（如 ip,port,domain），默认返回权限内所有可导出字段。--file上传的CSV文件路径，用于批量查询--type上传文件的类型，即检索类型： all (混合ip/domain/company), ip(批量ip), domain(批量域名), company(批量企业名称)，用于批量查询--limit最大导出资产数--task_id任务 ID，用于查看进度或下载文件--output下载的输出文件名，用于下载文件命名

🛠️ 脚本工具#

• scripts/query.py

📚 参考文档#

• reference/api.md: Hunter 查询接口文档
• reference/api_batch.md: Hunter 批量查询相关接口文档
• reference/batch_file_template.csv: 批量查询时使用的上传文件模板