- name
- qax-hunter-use
- description
- 用于调用奇安信 Hunter OpenAPI 进行资产批量导出。用户提到 Hunter、资产测绘、批量导出、task_id 下载文件等需求时优先加载本 skill。
QAX Hunter Use
First
- 默认走 API 模式，不使用文件上传。
- 查询语法由用户输入，脚本自动做 RFC 4648 base64url 编码。
- 批量任务流程固定为：
1) 创建任务 /openApi/search/batch 2) 查询进度 /openApi/search/batch/{task_id} 3) 下载结果 /openApi/search/download/{task_id}
入口脚本
- 主脚本：
scripts/hunter_batch_cli.py - 运行方式：
- AI 无交互推荐： - python3 scripts/hunter_batch_cli.py --no-interactive --api-key "$HUNTER_API_KEY" --search 'web.title="test"' --check-delay 10 --json-output - 兼容交互： - python3 scripts/hunter_batch_cli.py
参数说明
- 必填：
api-key - 常用可选：
search、start_time、end_time、is_web、status_code、fields、assets_limit - AI 友好参数：
- --no-interactive：禁止交互输入，缺参即报错 - --check-delay：创建任务后等待 N 秒（默认 10）再首次尝试下载 - --poll-interval / --poll-timeout：轮询控制 - --output-file：指定下载文件名 - --json-output：最后输出一行 JSON 结果，便于机器解析
安全注意事项
- 不要将真实
api-key写入仓库文件。 - 推荐使用环境变量注入：
HUNTER_API_KEY。 - 若必须持久化，请使用系统密钥环或加密配置文件，不要明文存储。