call_napcat_api
Calls any NapCatQQ OneBot 11 action as a fallback when dedicated tools do not cover an operation, enabling access to additional QQ APIs.
Instructions
调用 NapCatQQ 任意 OneBot 11 标准或扩展底层 Action(覆盖全部 144+ 项功能)的通用兜底透传工具。
适用场景:仅当核心专用工具未覆盖所需功能时使用(例如查询历史记录 get_friend_msg_history/get_group_msg_history、群管禁言踢人 set_group_ban/set_group_kick、文件下载与 OCR download_file/ocr_image、好友与资料管理 get_friend_list/set_qq_profile、群相册或打卡等)。不适用与替代:严禁使用本工具替代已暴露的核心专用工具(发送私聊/群聊请用 send_private_msg/send_group_msg,撤回请用 delete_msg,上传文件请用 upload_private_file/upload_group_file);不确定 action 精确名称时,请先调用 list_supported_napcat_actions 检索。
参数约束与交互:action 必须为合法的 OneBot 11 / NapCat 端点名(不含前导斜杠 /);params 为传给该端点的 JSON 键值字典,上传或下载大文件时建议将 timeout 调大至 120.0。
行为、权限与副作用:操作性质完全取决于所调用的 action——get_*/fetch_* 为只读查询,而 delete_*/set_group_kick/set_group_leave 属于不可逆破坏性操作且要求当前账号已在线并具备相应群主/管理员权限;返回标准 OneBot 响应字典 {"status": "ok"|"failed", "retcode": int, "data": ...},未知 action 或参数错误时返回非 0 retcode 并提示调用 list_supported_napcat_actions。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "call_napcat_api"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | 目标 OneBot 11 或 NapCat 扩展接口精确名称(可通过 `list_supported_napcat_actions` 查阅,如 'get_group_msg_history', 'set_group_ban', 'ocr_image') | |
| params | No | 传递给该接口的请求参数字典(字段依具体 action 而定,无参数接口传空字典 {} 或省略) | |
| timeout | No | HTTP 请求最大等待超时秒数(常规接口默认 30.0,文件传输类接口建议 120.0) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | 接口返回的业务负载数据(对象或数组,具体字段依工具而定) | |
| status | No | 执行状态标识,成功为 'ok'(或特定生命周期状态),失败为 'failed' 或 'error' | |
| message | No | 状态说明或错误诊断详情 | |
| retcode | No | OneBot 11 响应状态码,0 表示成功,非 0 表示协议端或网络错误 |