back
loading skill details...
用于调用奇安信 Hunter OpenAPI 进行资产批量导出。用户提到 Hunter、资产测绘、批量导出、task_id 下载文件等需求时优先加载本 skill。
---
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`。
- 若必须持久化,请使用系统密钥环或加密配置文件,不要明文存储。
don't have the plugin yet? install it then click "run inline in claude" again.