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。
• 若必须持久化，请使用系统密钥环或加密配置文件，不要明文存储。