amazon-creators

Amazon Creators API MCP - 直接在聊天中生成可直接粘贴的联盟产品卡片

如果你写过产品合集文章，就知道最枯燥的部分是什么：在 Amazon 上找到产品，复制图片，获取价格，粘贴联盟链接，还得祈祷有人读到文章时价格没有变。然后再为接下来的 9 款产品重复一遍。

这款工具会帮你搞定这些事。你让 Claude 找某样东西，它就会搜索 Amazon 实时目录，并返回一张完整的 HTML 卡片——包含图片、价格、优惠金额、星级评分、已加入你的 Associates 标签的链接，以及 Amazon 要求添加的披露说明页脚。把它粘贴到 WordPress、Ghost、Substack 或你使用的其他平台即可。在 Claude Desktop 中，你甚至可以在复制前预览卡片的渲染效果。

它基于 Amazon Creators API 构建——这是一个 REST API，Amazon 于 2026 年 5 月 15 日停用旧版 Product Advertising API 5.0 端点后，用它取而代之。如果你的工作流还在使用 PA-API，那它早就不能用了。现在可以通过这个工具重新接入。

只需说一句「把这些做成网格」，就能得到这样的效果——样式已内联，每个链接都包含标签，底部附有披露说明。粘贴好就可以继续下一步。

快速导航

适用对象 · 实际使用方式 · 获取 API 密钥 · 安装 · 环境变量 · 工具 · 输出格式 · 样式 · Associates 合规要求 · 故障排除

---

适用对象

• 联盟营销博主和细分网站站长：经常撰写产品合集和「适合 Y 的最佳 X」文章，希望在几秒钟内完成产品嵌入，而不必手动操作。
• 内容和 SEO 团队：需要在大量文章中使用统一的品牌产品卡片，又不想每次都让开发人员接入 API。
• 新闻简报作者：在 Substack、Ghost 或 beehiiv 上发布内容，只需要可以直接插入文章的简洁 HTML。
• 所有从 PA-API 5.0 迁移的用户：旧端点已停用，现在需要一个可用的替代方案。

你不需要了解 API 是什么也能使用它——只要能在 Claude 中添加 MCP 服务，并一次性粘贴 Associates 密钥，就可以开始使用。关键是你需要拥有符合资格的 Associates 账户，详见获取密钥。

---

实际使用方式

整个工具围绕对话而非表单构建。你描述正在撰写的内容，Claude 会搜索并总结；只有在你要求生成嵌入内容时，它才会输出 HTML。使用流程大致如下。

1. 查找适合文章的产品

“帮我找找 £500 以下最好的直驱赛车方向盘”

Claude 运行 search_items，并返回一段纯文本摘要——还没有 HTML：

找到 8 款 £500 以下的直驱方向盘。值得关注的有： • Fanatec CSL DD（£349）——评价不错，配备 5 Nm 电机 • Moza R5 Bundle（£469）——附带踏板，扭矩为 5.5 Nm • Cammus C5（£399）——小巧紧凑 要我为这些产品生成可嵌入的网格吗？

2. 生成卡片或网格

“好，帮我把排名前三的做成网格”

这时它会切换到 format: 'html-grid'，并返回完整的 HTML 文档。图片、价格、节省金额、星级、你的标签、“截至”时间戳、披露说明页脚，应有尽有。粘贴即可。

3. 更改样式，不耗尽速率限制

这一步最省事。Creators API 有实际的速率限制（起步时大约每秒一个请求，随着你带来的销售额增加而提高），所以你不会想每次想换个颜色就重新查询 Amazon。其实没必要。Claude 会保留上次调用的数据，并在本地重新渲染：

“网格保持不变，但卡片改成深色，按钮用亮粉色”

{
  "response": { "searchResult": { "items": [ /* from the previous call */ ] } },
  "format": "html-grid",
  "customStyles": ".amzn-card{background:#0f172a;color:#f1f5f9} .amzn-card__cta{background:hotpink;color:#111}"
}

修改样式 20 次，也不会多调用一次 API。尽情调整外观吧。

4. 查询指定的 ASIN

“帮我查一下 B09B2SBHQK、B08N5M7S6K 和 B0BZC6YR7Q 的最新详情”

Claude 会调用 get_items，并总结这三款产品。有一点值得注意：API 不保证按你请求的顺序返回商品，而且会悄悄丢弃无法找到的 ASIN（这些会放在单独的 errors 数组中）。Claude 会根据 asin 字段进行匹配，所以你无需操心。

5. 列出颜色和尺寸变体

“Echo Show 5 有哪些颜色？”

这时会调用 get_variations——它会列出父 ASIN 下的子商品，每个商品都有自己的价格。

---

获取 API 密钥

很多人会卡在这一步，所以我直说：**Creators API 并非对所有人开放，而且需要经过销售资格审核。**花一下午研究之前，最好先了解这一点。

你需要先满足的条件

• 面向目标商城的已获批 Amazon Associates 账户（.com 账户无法用于 .co.uk——凭据与地区绑定）。
• **过去连续 30 天内至少有 10 笔符合条件的已发货销售。**这一点最容易让人栽跟头。如果账户在任何滚动 30 天窗口内的销售额跌至 10 笔以下，访问权限就会被暂停，直到销售额重新达标。新账户或不活跃账户暂时无法使用 API。
• 你必须是主账户所有者。Associates 账户的次级用户无法查看 Creators API 页面，也无法生成密钥。根据我的经验，这比其他任何问题都更容易给团队造成麻烦。
• 运行 MCP 的机器上需要安装 Node.js 20 或更高版本。

在哪里创建凭据

登录 Associates Central，打开 Tools 菜单并选择 Creators API，或者直接访问 affiliate-program.amazon.com/creatorsapi。接下来只需三个步骤。

1. 创建 Creators API 应用

2. 命名并选择地区

你在这里选择的地区决定了 AMAZON_CREDENTIAL_VERSION（NA = 3.1，EU = 3.2，FE = 3.3，完整表格见下文）。请选择与你实际撰写内容所面向的市场相符的地区。

3. 复制 Credential ID 和 Secret

Amazon 会生成一组 Login with Amazon（v3.x）凭据。复制两项内容：ID 填入 AMAZON_CLIENT_ID，Secret 填入 AMAZON_CLIENT_SECRET。这些凭据始终保留在你自己的设备上。MCP 服务会直接与 Amazon 通信，不会向 Houtini 或其他任何人发送信息。

**关于旧版 v2.x 凭据：**如果你在 2026 年初之前设置过应用，可能还留有 v2.x Cognito 凭据。这些凭据无法在此使用。请创建一个新的 Login with Amazon 应用以获取 v3.x 密钥。服务会在启动时检查凭据，并拒绝 v2.x 凭据，同时明确告知你这一点，因此你不必猜测原因。

---

安装

使用时无需克隆任何内容，npx 会获取已发布的软件包。只需准备好五个环境变量。

Claude Desktop

打开配置文件：

• Windows： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazon-creators": {
      "command": "npx",
      "args": ["-y", "@houtini/amazon-creators-mcp"],
      "env": {
        "AMAZON_CLIENT_ID": "amzn1.application-oa2-client.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "AMAZON_CLIENT_SECRET": "amzn1.oa2-cs.v1.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "AMAZON_PARTNER_TAG": "yourtag-20",
        "AMAZON_CREDENTIAL_VERSION": "3.1",
        "AMAZON_MARKETPLACE": "www.amazon.com"
      }
    }
  }
}

重启 Claude Desktop，然后说 “在 Amazon 上帮我找找关于[你正在写的主题]的内容”，就可以开始了。

Claude Code（CLI）

claude mcp add \
  -e AMAZON_CLIENT_ID=amzn1.application-oa2-client.xxx \
  -e AMAZON_CLIENT_SECRET=amzn1.oa2-cs.v1.xxx \
  -e AMAZON_PARTNER_TAG=yourtag-20 \
  -e AMAZON_CREDENTIAL_VERSION=3.1 \
  -e AMAZON_MARKETPLACE=www.amazon.com \
  -s user amazon-creators -- npx -y @houtini/amazon-creators-mcp

运行 claude mcp get amazon-creators 检查是否配置成功，你应该能看到 Status: Connected。

---

环境变量

变量	必填	示例	说明
AMAZON_CLIENT_ID	是	amzn1.application-oa2-client.…	Creators API 应用中的 “Credential Id”
AMAZON_CLIENT_SECRET	是	amzn1.oa2-cs.v1.…	同一位置的 “Secret”
AMAZON_PARTNER_TAG	是	yourtag-20	你的 Associates 跟踪 ID
AMAZON_CREDENTIAL_VERSION	是	3.1 / 3.2 / 3.3	与地区相关，见下表
AMAZON_MARKETPLACE	是	www.amazon.com	完整的市场主机名
AMAZON_MAX_CONCURRENCY	否	4	同时进行的最大请求数。默认值为 4。
DEBUG	否	1	输出大量 stderr 日志。默认关闭。

各地区的凭据版本

你的凭据绑定到一个地区，在该地区之外调用市场会导致身份验证失败。因此，服务会在启动时交叉检查这些设置，尽早停止运行，避免你等到发出请求时才发现问题。

地区	版本	市场
NA	3.1	www.amazon.com，www.amazon.ca，www.amazon.com.mx，www.amazon.com.br
EU	3.2	www.amazon.co.uk，www.amazon.de，www.amazon.fr，www.amazon.it，www.amazon.es，www.amazon.nl，www.amazon.com.be，www.amazon.eg，www.amazon.in，www.amazon.ie，www.amazon.pl，www.amazon.sa，www.amazon.se，www.amazon.com.tr，www.amazon.ae
FE	3.3	www.amazon.co.jp，www.amazon.sg，www.amazon.com.au

---

工具

工具	输入	功能
search_items	keywords / actor / author / brand / title + 筛选条件	搜索目录。每页最多 10 个商品；使用 itemPage 翻页。
get_items	asins: string[]（1-10）	查询指定的 ASIN。根据 asin 匹配结果，而不是根据你发送的顺序。
get_variations	asin: string	查询父 ASIN 下的尺寸 / 颜色子商品。
get_browse_nodes	browseNodeIds: string[]	查询分类元数据和祖先链。仅支持 json / markdown。
format_items	之前调用返回的 response 或 items[]	重新渲染已获取的数据。不会调用 Amazon。 这让你可以免费调整样式。

面向 Amazon 的四种工具都接受以下参数：

• format - 'json' | 'markdown' | 'html-card' | 'html-grid' | 'html-deals'（默认值为 markdown；get_browse_nodes 仅支持 json | markdown）
• resources - 要获取的字段，以 camelCase 路径表示（例如 itemInfo.title、offersV2.listings.price）。省略此参数时会使用合理的默认字段集。
• customStyles - 渲染 HTML 时，附加到内置样式表的额外 CSS。对于 html-deals，它会放在行内容前的独立 <style> 块中，因此你可以调整站点样式，而无需引入完整样式表。
• titleMaxChars - 限制渲染标题的长度（默认值为 80）。Amazon 标题通常有 150 多个字符，堆满关键词；限制为 80 个字符可以让卡片标题保持一行。设为 0 可关闭限制。Markdown 和 JSON 始终会返回完整标题。
• hideItemsWithoutPrice - 对于 html-grid，隐藏没有价格的商品（默认值为 true）。没有价格的卡片嵌入效果不佳——没有吸引点，也没有可供点击的内容。如果你要制作商品对比表，并且希望无论如何都显示商品，请设为 false。

---

适配你的网站，而非工具的优惠商品行

下面的格式都会生成卡片样式的卡片。这适合一次性的嵌入，但如果放进已有站点样式的文章中，就不合适了——最终会让别人的设计出现在你的文章中。

html-deals 会输出结构化标记：用 .amazon-deals-section 包裹每个商品对应的 .amazon-deal-row。如果你的主题已定义这些类，输出内容会继承这些样式，无需重新调整。如果没有，可以用 format_items 重新渲染，并设置 includeCss: true，即可获得合理的默认样式：

Find me three burr coffee grinders and give me deal rows for the post

每行固定为 70px 高，这样十款商品看起来像一份便于浏览的清单，而不是十屏滚动内容。出于同样的原因，默认不显示特色要点——如果需要，可以在 format_items 中设置 featureCount，并在自己的 CSS 中取消行的 max-height，以腾出空间。想在商品行上方显示标题？在 format_items 中传入 heading（“添加标题 ‘Our top picks for 2026’”），即可生成 <h3 class="amazon-deals-header">。

以下两项不会显示：

• Prime 徽章。 Creators API 的响应中没有说明商品是否符合 Prime 配送条件，因此声称符合就等于凭空捏造配送承诺，而访客可能会在该页面购买商品。
• 空星级。 评论数据因 Associates 账户而异，受到限制；Amazon 未返回评论数据时，会省略评分行，而不是将其渲染为零。

关于星级评分的说明

每次调用都会请求 customerReviews.starRating 和 customerReviews.count，但 Amazon 只会为有资格获取这些数据的账户返回这些信息。如果你的商品行没有星级，问题出在账户，而不是工具——这些字段已正确请求，格式化器也会妥善处理缺失数据，而不是凭空生成评分。

---

输出格式

• markdown —— 图片、链接标题、价格、披露信息。可直接粘贴到博客编辑器中。标题完整显示，不会截断。
• html-deals —— 可继承网站 CSS 的结构化优惠信息行。参见上文。适用于文章。
• html-card —— 一个样式内联、自包含的 <article class="amzn-card">。标题最多显示 titleMaxChars 个字符。如果没有价格，会显示颜色较淡的“在 Amazon 上查看价格”链接，确保卡片仍有可点击的链接。
• html-grid —— 用于搜索结果或列表的响应式卡片网格。默认会移除没有价格的商品。
• json —— 解析后的响应，以美化格式显示。可用于查看 Amazon 实际返回的内容。

如果你不想处理 HTML，markdown 是最方便的格式。只要提出请求，就会得到如下内容，可直接放进文章：

[![Fanatec CSL DD Direct Drive Wheel Base (5 Nm)](https://m.media-amazon.com/images/…jpg)](https://www.amazon.com/dp/B0EXAMPLE01?tag=yourtag-20)
**[Fanatec CSL DD Direct Drive Wheel Base (5 Nm)](https://www.amazon.com/dp/B0EXAMPLE01?tag=yourtag-20)**
Brand: Fanatec · 4.7★ (1,284 reviews)
**£349.95** — save £40.00 (10% off) _(as of 20 Jul 2026, 15:24 UTC)_
ASIN: `B0EXAMPLE01`

> *As an Amazon Associate we earn from qualifying purchases. Prices and availability are accurate as of the time shown and are subject to change.*

在 Claude Desktop 中，卡片会在复制前以内嵌方式呈现，并使用官方 MCP Apps 协议 —— 这是一个沙盒预览，让你无需盲目粘贴。预览中有一个 复制 HTML 按钮，只会复制可嵌入的部分：原样复制 html-deals 片段，或者复制卡片或网格的 <style> 加上正文标记，不包含 <!doctype>/<html> 外层标签。在尚不支持 MCP Apps 的宿主环境中，你仍会得到纯文本 HTML，正是你本来就要粘贴的内容。不会遗漏任何内容。

---

卡片样式

卡片中每个可见元素都有稳定的类名钩子，因此你可以通过对话重新设置整个卡片的样式，无需任何人修改代码：

.amzn-card                    .amzn-card__image              .amzn-card__title
.amzn-card__meta              .amzn-card__brand              .amzn-card__rating
.amzn-card__price             .amzn-card__price--unavailable .amzn-card__savings
.amzn-card__cta               .amzn-card__disclosure         .amzn-grid

例如，这样就可以：

“把 CTA 改成亮粉色，并将卡片设为深色圆角矩形。”

{
  "keywords": "coffee grinder",
  "format": "html-card",
  "customStyles": ".amzn-card{background:#0f172a;color:#f1f5f9;border-radius:20px} .amzn-card__cta{background:hotpink;color:#111}"
}

customStyles 会追加到默认样式表之后，因此你的规则会因顺序靠后而优先生效。只需匹配一次网站的外观，之后每次渲染都可以重复使用相同的 CSS。

---

Associates 合规

展示 Amazon 商品数据需要遵守规则；如果弄错，可能会影响你的账户。因此，服务会自动处理这些繁琐但重要的事项：

• 每个外链都会附上你的 AMAZON_PARTNER_TAG。它会优先使用 Amazon 返回的、已带标签的 detailPageURL；如果没有，则会回退到 /dp/ASIN?tag=… 链接。
• 每个链接都带有 rel="nofollow sponsored noopener"。
• 每当显示价格时，也会显示获取该价格的时间（as of <timestamp>）。
• 每张卡片和每个网格的末尾都会附上 Associates 披露页脚。

根据 Associates Operating Agreement，这些要求无一例外，因此它们会自动处理，而不是让你自己记着去做。

---

开发

git clone https://github.com/houtini-ai/amazon-creators-api-mcp
cd amazon-creators-api-mcp
npm install
npm run build

命令	作用
npm run build	构建全部内容（查看器包 + TypeScript）
npm run build:viewer	仅构建 MCP Apps 查看器 HTML 包
npm run dev	以监视模式运行服务端 TypeScript
npm run test	vitest（103 项测试，单元测试 + 集成测试）
npm run typecheck	仅检查类型，不生成输出
npm run lint	ESLint

如果你有可用的凭据，运行 npx tsx scripts/smoke-auth.ts 会实际获取令牌并调用一次 searchItems，这是最快确认密钥端到端可用的方法。

请参阅 SCOPE.md，了解架构以及值得注意的 API 特性。

---

故障排查

启动时出现“Credential version rejected” - 你使用的是 v2.x Cognito 凭证。请在 Associates Central → Creators API 中创建一个新的 Login with Amazon 应用，然后根据所在地区将 AMAZON_CREDENTIAL_VERSION 设为 3.1、3.2 或 3.3。

出现 401 或 403 错误 - 通常有两个原因：你的 Associates 账户在过去 30 天内没有 10 笔符合条件的销售，或者该账户尚未启用 Creators API 访问权限。你可以在 Associates Central 中检查这两项。

启动时出现地区不匹配错误 - 你的凭证版本和市场所在地区不同（例如，将 3.1 北美密钥用于 www.amazon.co.uk）。请使用为你所调用的市场所属地区签发的凭证。

Claude Desktop 中未显示预览图像 - 查看器仅允许 Amazon 自有的图像 CDN。在策略更严格的主机上，预览图像可能无法加载，但纯 HTML 输出不受影响，粘贴到你的网站后即可正常渲染。

“返回的商品顺序不正确” - 这是预期行为。get_items 可以按任意顺序返回商品，并会将无法找到的 ASIN 放入单独的 errors 数组。请根据 asin 字段进行匹配。Claude 会在生成摘要时替你完成这项工作。

---

许可证

MIT。请参阅 LICENSE。

---

由 Houtini 为模型上下文协议社区构建，属于 houtini-ai MCP 套件的一部分。