Amazon API 规范底座
登录 注册
接入
MCP 协议 2026-07-28 · 无状态 · 国内直连

让 agent 按权威规范调 Amazon API，
而不是凭记忆猜。

Amazon SP-API 与 Ads API 的权威接口规范服务。覆盖 138 个 API 规范、1,159 个 operation、 9,663 个 schema，随 Amazon 变更持续跟进。 你的 agent 每次动手之前，都能拿到准确的路径、必填参数、限流值与废弃标记，并据此生成可执行请求。

一条命令接入 查看文档
bash 
claude mcp add --transport http amazon-spapi https://mcp.sp-api.net/mcp/sp-api

不需要注册，不需要密钥。装完重启会话即可用。

从零到第一次调用

三步就能用

不需要注册、不需要申请、不需要等审核。装完重启一次 agent 会话，就可以直接问了。

接入

一条命令写进你的 agent 配置，重启会话。SP-API 与 Ads 是两个独立 endpoint，只用一个就只装一个。

bash 
claude mcp add --transport http amazon-spapi https://mcp.sp-api.net/mcp/sp-api

直接问

不用学工具名，不用背 operationId。用人话提问，模型自己走「先检索、再取签名、最后生成请求」的漏斗。

你：getOrders 的限流是多少？
你：帮我拉 us-main 店铺上周的订单。

拿到可执行的东西

返回准确签名与一条能直接跑的 curl。凭证位置是占位符，由你本地填——服务端从头到尾不接触你的 token。

json
"auth": { "header": "x-amz-access-token",
          "value":  "${AUTH_TOKEN}" }
138
API 规范
SP-API 66 · Ads 72
1,159
operation
SP-API 370 · Ads 789
9,663
schema 定义
SP-API 2,457 · Ads 7,206
269
官方请求示例
Amazon 官方 Postman 真实请求体
80 个「有请求、无公开规范」的端点被单独收录 全部索引常驻服务端，一个字节都不下发。
先说清楚买的是什么

三件事

不是又一个 Amazon API 代理

代理只是替你转发——Amazon 官方自己就有，没有护城河。我们提供的是 调用之前必须知道的那些事实：准确路径、必填参数、限流值、废弃标记、鉴权头组合， 并据此直接生成可执行请求。

模型不再猜路径、猜参数名、猜限流值——每一次动手之前都能拿到规范原文。

凭证永不离开你的机器

我们只回答「该怎么调」，从不代你调。 request 工具返回的请求描述里，凭证位置是 ${AUTH_TOKEN} 占位符， 由你本地的执行器填充。

refresh token、client secret、RDT 全部留在你的机器上（加密存盘 + 系统 keychain）。 我们既不接触你的 Amazon 凭证，也不接触你的业务数据——服务端一律不存。

不装执行器也能用一半

没装本地执行器同样有用：request 返回的结果里自带一条可直接跑的 curl， 复制到终端手动执行，效果完全一样。

执行器（几十 KB，零第三方依赖）只是把 LWA token 刷新、429 退避、NextToken 翻页、 多店铺切换这些琐事自动化。它是「哑」的，全部智能在服务端。

为什么模型自己答不对

凭记忆 vs 查规范

Amazon 的 API 每个月都在变，而模型的训练数据有截止日。更麻烦的是模型不知道自己不知道—— 它会用非常自信的语气给出一个 2023 年的限流值。下面每一行都是真实存在的坑。

模型凭记忆回答
  • 限流「getOrders 大概每秒 1 次」——真实值是 0.0167 次/秒，差 60 倍，循环调用直接 429
  • 废弃照旧写着已 deprecated 的 operation，不知道有替代品
  • 鉴权把 Amazon-Advertising-API-ClientId 和 Amazon-Ads-ClientId 混着用 → 401
  • 存在性规范里搜不到，就断言「这个端点不存在」
  • 参数必填项漏了，等 400 回来才知道少了 MarketplaceIds
  • 时效训练截止日之后的所有变更，一概不知
先查权威规范
  • 限流spapi_op 返回 rps: 0.0167 / burst: 20，并附一句「拉历史订单请改用 createReport」
  • 废弃deprecated: true 与 successor 一并返回，模型必须说出来
  • 鉴权ads_show 给出该 operation 准确的头组合，两套体系自动区分
  • 存在性ads_gap 收录 80 个「Amazon 自己在调、却没有公开规范」的端点
  • 参数validation.missing 在发请求之前就列出缺了哪个必填项
  • 时效规范随上游持续更新，spapi_changelog 可查变更记录
一次真实调用

典型调用链

我们的服务端 · 只回答「该怎么调」
spapi_search 「订单」→ 定位候选 operation，返回精简行
spapi_op 取权威签名：必填参数、schema、限流 0.0167/s、是否废弃
spapi_request 生成可执行请求描述 + 一条能直接跑的 curl
你的机器 · 凭证与执行
本地执行器 / curl 填入 LWA token，直连 Amazon，自动翻页与退避。结果不回传我们。

服务端是纯函数：给定 operation 与参数，返回请求描述。它不知道你有几个店、店在哪、卖什么， 也不需要任何跨调用状态——所以能水平扩展，也能整包私有化交付。

按需接入

两个独立 endpoint

SP-API 与 Ads 完全分开，各自一套工具集，配置也分开。只用 SP-API 的客户不必装 Ads， 可省下约 2,100 tokens 的常驻上下文——那是每一轮对话都在省。 额度共享同一个池，装一个还是两个都不影响计费方式。

sp-api

SP-API 知识底座

9 个工具

订单、库存、商品、报告、Feed、通知——66 个 API 的权威签名与限流。

https://mcp.sp-api.net/mcp/sp-api
ads-api

Ads API 知识底座

10 个工具

SP / SB / SD / DSP / AMC——72 个规范，外加 269 个 Amazon 官方真实请求体。

https://mcp.sp-api.net/mcp/ads-api
定价

额度给得很慷慨

查看完整定价与常见问题 →

不注册也能直接用（按 IP 给免费额度）。要更高额度、要看用量、要管密钥时才注册。

Dev 开发版
¥ 138 / 月
100,000 次调用 / 月
选择
多数团队的选择
Pro 专业版
¥ 358 / 月
500,000 次调用 / 月
选择
Team 团队版
¥ 1458 / 月
2,000,000 次调用 / 月
选择

一个开发者日均 50–200 次调用，折合每月 1,500–6,000 次。Dev 档给 10 万次，实际用量约 5%。 额度用尽不会突然断掉：100% 之后还有 10% 宽限额度。

先跑一次，再决定

一条命令接进你现在用的 agent，然后问它「getOrders 的限流是多少」。 看看返回的数字和你记忆里的是不是一回事。

看安装步骤