MCP 接入
MCP把亚马逊评论数据接进 WorkBuddy、Codex 等支持 MCP 的 Agent，与传统 REST 接口共用同一套计费。
同一个数据，两种取法：传统方式用 REST 接口（GET https://api.xdata-fly.com/v1/...），Agent 方式直接接入本页的 MCP 端点。两者共用同一条计费与限流链路 —— MCP 里的每次工具调用，跟你自己发一次 API 请求的扣费完全一致。
端点与认证
MCP 端点采用标准 Streamable HTTP 传输，认证方式与 REST 接口一致：在请求头里带 secret-key。
端点地址
text
https://api.xdatafly.com/mcp认证请求头
http
secret-key: sk_live_xxxxxxxxxxxxxxxx可用工具
| 工具 | 说明 | 状态 |
|---|---|---|
| amazon_reviews | 按 ASIN 抓取亚马逊商品评论，返回评分、标题、正文、作者（已掩码）、是否已验证购买、有用票数、日期与国家。参数: asin（必填）、page_count、sort、star、site、include_media | 可用 |
| google_search | 谷歌搜索结果的结构化数据。参数: q、gl、hl、num、device | 待开放 |
通用 MCP 客户端
支持远程 MCP 的客户端（Cursor、VS Code、Cherry Studio 等）打开 MCP 配置文件，加入下面这段即可。
json
{
"mcpServers": {
"xdata-fly": {
"url": "https://api.xdatafly.com/mcp",
"headers": {
"secret-key": "sk_live_xxxxxxxxxxxxxxxx"
}
}
}
}接入 Codex
Codex CLI 的 MCP 配置在 ~/.codex/config.toml。写入以下内容后重启 Codex：
toml
[mcp_servers.xdata-fly]
url = "https://api.xdatafly.com/mcp"
http_headers = { "secret-key" = "sk_live_xxxxxxxxxxxxxxxx" }也可以用命令一键添加：
bash
codex mcp add xdata-fly --url https://api.xdatafly.com/mcp --header "secret-key=sk_live_xxxxxxxxxxxxxxxx"接入 WorkBuddy
WorkBuddy 的 MCP 连接器配置在 ~/.workbuddy/mcp.json（Windows 为 C:\Users\你的用户名\.workbuddy\mcp.json）。把服务加进 mcpServers，保存后即可在对话里让 WorkBuddy 调用 amazon_reviews 工具。
json
{
"mcpServers": {
"xdata-fly": {
"url": "https://api.xdatafly.com/mcp",
"headers": {
"secret-key": "sk_live_xxxxxxxxxxxxxxxx"
}
}
}
}若你的 WorkBuddy 版本只支持 stdio 类型的连接器，请改用下一节的方式。
stdio 客户端（桥接）
只支持 stdio 的客户端，可以用 mcp-remote 把远端地址桥接成一条本地命令（需要已安装 Node.js）：
json
{
"mcpServers": {
"xdata-fly": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.xdatafly.com/mcp",
"--header",
"secret-key:sk_live_xxxxxxxxxxxxxxxx"
]
}
}
}计费
MCP 工具调用与 REST 接口共用同一套积分规则：成功才扣费，失败（参数错误、余额不足、上游失败、解析失败）一律自动退回预扣积分。返回体里同样会给出本次扣费与剩余余额。