magpie-tools

Magpie 网关 MCP 插件工具的零依赖 CLI：通过网关 MCP streamable HTTP 端点（无状态直调）列出并调用 search1api_*（网页搜索、新闻、网页抓取）与 goanyapi_*（网站流量、域名权重 DR/反链、关键词难度/搜索量/建议、Google/Bing/YouTube 自动补全、credits 余额等）两组插件工具。

运行方式（无需安装依赖）：

node skill.js <command> [args] [options]

快速开始

# 1. 列出当前可用的全部工具（工具清单随网关插件开关变化）
node skill.js list

# 2. 按关键词过滤工具（名称或描述，不区分大小写）
node skill.js list credits

# 3. 查询 goanyapi credits 余额（部分工具消耗 credits，先看余额）
node skill.js call goanyapi_credits_balance

# 4. 调用带参数的工具：--arg k=v 可重复，值自动尝试 JSON 解析
node skill.js call search1api_search --arg query=deepseek --arg maxResults=5

# 5. 复杂参数用 --args 一次传入完整 JSON 对象
node skill.js call search1api_search --args '{"query":"deepseek","maxResults":5}' --json

命令总表

选项表

认证与配置

配置优先级：命令行选项 > 环境变量 > .env > 默认值。.env 位于技能目录（已被 .gitignore 忽略，不入库），模板见 .env.example。

输出说明

• call 默认输出：网关会把插件结果二次 JSON.stringify 后塞进 result.content[0].text，本 CLI 自动再解析一层——解析成功则优先输出 structuredContent（机器可读数据），否则输出 content 中的文本；解析失败原样输出 text。
• call --json 输出解包后的完整结果对象（content + structuredContent），适合程序解析。
• 工具执行错误（isError: true）、鉴权失败（401）、未知工具（JSON-RPC -32602）统一以 {"error", "message"} JSON 输出到 stderr。

退出码

常见问题与避坑

Q1：需要先 MCP initialize 握手吗？

A：不需要。该端点是 streamable HTTP 的无状态直调模式，直接 POST tools/list / tools/call 即可，响应为 application/json（非 SSE）。

Q2：call 报 "unknown tool xxx" 是什么意思？

A：工具名格式为 <插件>_<工具>（search1api_* 与 goanyapi_*），且工具清单随网关插件开关变化。先 node skill.js list 确认当前可用工具名，再 call。

Q3：哪些工具消耗 credits？

A：goanyapi 系列多数工具按次消耗 goanyapi credits。可先 node skill.js call goanyapi_credits_balance 查询余额，再决定是否调用付费工具。

Q4：为什么返回 401 鉴权失败？

A：MAGPIE_API_KEY 缺失或不是已启用的 Magpie 网关密钥。检查 .env 或环境变量中的密钥配置。

Q5：--arg 传的数字变成了字符串（或反过来）？

A：--arg 的值先尝试 JSON 解析：k=5 得数字 5；需要保留 "005"、"1.0.0" 这类字符串时，改用 --args '{"k":"005"}' 显式声明类型。