Amazon API 规范底座
登录 免费开始
MCP 协议 2026-07-28 · 索引随 Amazon 变更持续更新

让 AI 先查规范，
再动亚马逊的接口

把 SP-API 与 Ads API 的权威规范接进你的 AI 客户端。限流、废弃标记、鉴权头、必填参数， 动手之前先核实：不猜、不编，也不经手你的密钥。

免费开始 看它怎么工作
  • 扫码注册即得 2,000 积分
  • 凭证不出你的机器
  • 两个 endpoint · 27 个工具

在你本机执行 · 凭证没有离开

接进任何 MCP 客户端 Streamable HTTP · OAuth 2.1 · 密钥两种都行
Claude Code ChatGPT / Codex CLI WorkBuddy Cursor VS Code 任何支持 Streamable HTTP 的客户端
索引规模

整套官方规范，装在服务端，一个字节都不下发

SP-API 与 Ads API 的 OpenAPI 规范、开发者文档与 Amazon 官方 Postman 请求体，做成一份离线快照， 随 Amazon 变更重建。下面的数字从索引里现算，不是写死的；变更记录能看到最近改了什么。

142份 OpenAPI 规范SP-API 70 · Ads 72
1,191个接口（operation）SP-API 384 · Ads 807
9,991个 schema 定义2,102 页官方文档全文索引
269个官方请求体来自 Amazon 官方 Postman 集合
为什么非得查一遍

模型不知道自己不知道

它答得很有把握，但没有机制让它知道自己记错了。下面每一格都是真实存在的坑，每一条都能用对应的工具现调复核。

限流

「getOrders 大概每秒 1 次」——差了 60 倍

真实值是 0.0167 次/秒、突发 20。凭记忆写个循环，上线就是 429。查过规范的 agent 会直接建议改走报告接口：提交一次即可。

模型凭记忆≈ 1 次/秒
规范里写的0.0167 次/秒
60×循环调用直接 429 · spapi_op orders-v0:getOrders
接口废弃

照旧写着已废弃的接口

废弃标记与替代接口一并返回，模型必须说出来，而不是某天悄悄失效。

deprecated: true → reports-2021-06-30:createReport
必填参数

发之前就列出缺了哪个

不用等 400 回来才知道少了参数。请求描述里必填项、可选项、要不要额外授权，发出去之前就清楚。

MarketplaceIds · required CreatedAfter NextToken
鉴权

Ads 有两套互不兼容的头

混着用就是 401——Ads API 最常见的报错。请求描述给出该接口声明的那一套，两套体系自动区分。

classic
Amazon-Advertising-API-ClientIdAmazon-Advertising-API-Scope
v1
Amazon-Ads-ClientIdAmazon-Ads-AccountId
媒体类型

带版本的 Content-Type

Ads 的新版接口要求厂商媒体类型，写成 application/json 会被拒。请求描述里直接给对。

application/vnd.spCampaign.v3+json
时效

训练截止日之后的变更，模型一概不知

索引随 Amazon 官方 changelog 重建，最近改了什么直接问 spapi_changelog。下面三条就是最新的。

来自 Amazon 官方 changelog，不手写全部变更记录 →
从零到第一次问

三步，从扫码到能问

没有审核、没有申请表。微信扫一下就有账号和密钥，装完重启一次会话就能问。

  1. 把右边这句话发给你的 AI

    它会给你一个链接，手机扫码即开通；密钥由它自己取回并写进配置，两个 endpoint 一起装。

  2. 用人话问

    不用学工具名，也不用知道接口叫什么。照你平时在后台想干的事说就行。

  3. 拿到能直接用的东西

    准确的调用方式与该知道的坑，外加一条能直接跑的请求；要它真去取数，再装本机执行器。

发给 AI 的一句话 
读 https://mcp.sp-api.net/llms.txt ，按里面的说明帮我接入 Amazon API 规范服务
手动配置？两条地址复制即用
sp-api https://mcp.sp-api.net/mcp/sp-api
ads-api https://mcp.sp-api.net/mcp/ads-api
按客户端分的完整片段 →
先说清楚这件事

你的密钥不会离开你的电脑

这是卖家最该问的一句话，所以放在最前面回答：我们只回答「该怎么调」，从不代你调。这条边界不是承诺，是结构——服务端根本没有你的凭证。

  • 不经手凭证返回的请求描述里，凭证位置是一个占位符。真正的 token 由你本机填进去。
  • 不碰你的经营数据订单、销量、广告花费从 Amazon 直接回到你的机器，中间不过我们这一道。
  • 停用也带得走执行器在你自己机器上，零第三方依赖，源码可逐行审；不续费它照样能跑。
装上就会的活

常干的活，交给它按步骤办

全部 Skills
本地执行器 把 request 描述真正发出去 接收 spapi_request / ads_request 返回的请求描述并执行：LWA token 刷新、RDT 换取、429 退避、自动翻页、多店铺连接、加密凭证保险箱。零第三方依赖。 sp-apiads-api 店铺信息管理 多店铺、多区域、多 profile 理清楚 把卖家账号、区域、marketplace、Ads profile 的对应关系理成一张明确的连接表，并做健康检查：授权是否还有效、每个连接能看到哪些商城、Ads profileId 属于哪个广告主。冒烟用的只读接口一句话向服务端问到。跨店误操作是最贵的错误，这个 Skill 的全部目的就是让它发生不了。 sp-apiads-api 需要执行器 广告诊断 401 / 403 / 空数据，先查这里 Ads API 最常见的三类问题：两套鉴权头混用、profileId 用错、报告请求参数不合法。先把状态码和发出的头交给 ads_diagnose 一次定位，再按固定顺序排查；每一步都从服务端取该接口的准确头组合与参数定义，而不是靠猜。整个排查通常只问服务端两次。 ads-api 需要执行器
定价

一个数字就够记：1 积分 = 1 次调用

人民币结算，按月订阅，随时可停。注册即得 2,000 积分，之后每天再送 100，进永久钱包不清零。60 秒内的重复调用只计一次。

完整定价与常见问题
Free ¥0/月 3,000 积分
Dev ¥138/月 100,000 积分
多数团队的选择 Pro ¥358/月 500,000 积分
Team ¥1458/月 2,000,000 积分
先跑一次

先跑一次，再决定值不值

装完问它一句：getOrders 的限流是多少？
它要是能一口报出 0.0167 次/秒，还劝你改走报告接口，这事就成了。

免费开始 看接入文档

扫码注册立得 2,000 积分 · 每天再送 100 · Dev 档 ¥138/月