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