Amazon Ads

短片展示的是使用示例数据的托管版 getmcpads。它的 MCP Apps 涵盖创意素材库、提醒、Google Sheets 导出和批量投放，均属于托管产品。本仓库提供独立的原生 API 工具。

31 个读取工具 · 77 个写入工具，默认禁用。

使用您自己的 Login with Amazon 应用，以及支持 stdio MCP 的客户端（例如 Claude Desktop、Claude Code 或 Cursor）在本地运行。您的请求会直接发送至 Amazon Ads API。如需托管连接（包括受支持的 ChatGPT 配置），请使用托管版。

最新动态

v1.0.0：首个独立版本 · 2026 年 10 月 23 日

• 移植 getmcpads 网关在修订版本 3e1c2c8 中的原生 Amazon Ads 工具：30 个用于 Sponsored Products、Sponsored Brands 和 Sponsored Display 配置的读取工具，覆盖 Reporting v3、创意素材库和产品元数据；另有 77 个写入工具和 3 个资源。
• 新增 amazon_ads_list_profiles，仅返回 AMAZON_ADS_PROFILE_IDS 中的配置文件，并列出已配置但 Amazon 未返回的配置文件名称。
• 使用 39 份固定的 Amazon 请求契约验证每项 Sponsored Brands 和 Display 写入操作。将每个预览令牌绑定到更改内容及从 Amazon 读取的实体，并拒绝过期或已更改的确认。
• 新建的广告活动、广告组和广告均以暂停状态创建。将会启动投放的更改标记为 activationMaySpend。
• 从 AMAZON_ADS_* 变量读取凭据。在内存中通过区域令牌 URL 使用刷新令牌续订访问令牌，且绝不将令牌写入磁盘。
• 在 src/core/hosts.ts 中声明 Amazon 的区域 API 和令牌主机。对于未设置 redirect: "error" 或超时的 fetch，以及源码中出现的任何其他主机，测试都会失败。
• 要求使用包含 2026 年 10 月安全修复的 Node.js 版本；运行服务器时若使用较旧版本，会在 stderr 输出警告。
• 从对应标签发布每个版本：先发布到 npm（附带来源证明），再发布 GitHub 版本，最后发布到 MCP Registry。

完整更新日志 · 所有版本

源代码同步：SOURCE_SYNC.md。

升级说明

需要 Node.js 22.23.4、24.22.1、26.12.1 或更高版本。这些版本包含 2026 年 10 月的安全修复；如果服务器在更早的版本上运行，会向 stderr 输出警告。CI 覆盖 Node 22、24 和 26。

这是首个版本。从托管版 getmcpads 保存的参数可能使用带区域前缀的账户 ID，例如 EU:1234567890；当区域与 AMAZON_ADS_REGION 一致时，系统会接受这些 ID。

安装此版本

这是 GitHub 源码版本。npm 和 MCP Registry 版本会单独发布。以下命令会选择此确切版本；本文档后面的未固定 npx 示例会选择当前在 npm 上提供的版本。

git clone --branch v1.0.0 --depth 1 https://github.com/get-mcp-ads/amazon-ads-mcp-server.git
cd amazon-ads-mcp-server
npm ci
npm run build

配置 MCP 客户端，使其运行 node，并传入 dist/cli.js 的绝对路径以及下文所述的凭据。

更倾向于托管连接？ 通过托管版 getmcpads 使用 Amazon Ads。连接账户，选择助手可访问的数据，然后使用托管 MCP 连接。当前功能和方案请参阅网站。

配置

通过客户端的机密配置提供以下环境变量：

变量	用途
AMAZON_ADS_CLIENT_ID	具有 Amazon Ads API 访问权限的 Login with Amazon 安全配置文件的客户端 ID。
AMAZON_ADS_CLIENT_SECRET	该安全配置文件的客户端密钥。
AMAZON_ADS_REFRESH_TOKEN	授权许可中的刷新令牌。以 Atzr| 开头。由于访问令牌（Atza|）会在一小时后过期，因此不予接受。
AMAZON_ADS_REGION	NA、EU 或 FE。用于选择 API 主机和令牌 URL。请选择下方配置文件所属的区域。
AMAZON_ADS_PROFILE_IDS	必填的广告配置文件 ID，多个 ID 以逗号分隔。在发出任何请求前，系统会拒绝其他所有配置文件的请求，包括读取请求。
AMAZON_ADS_ENABLE_WRITES	默认为 false。只有值精确为 true 时才会开放写入工具。

如需获取这些值，请按照 Amazon 提供的指南操作：

1. 注册 Amazon Ads API，并记下 Login with Amazon 安全配置文件的客户端 ID 和密钥。
2. 使用范围 advertising::campaign_management 创建授权许可，然后生成访问令牌和刷新令牌。Amazon 说明，2026 年 7 月 30 日或之后签发的刷新令牌会在广告主同意后的 365 天过期。
3. 获取配置文件 ID，并将此服务器可使用的 ID 列入 AMAZON_ADS_PROFILE_IDS。

此软件包不会运行 OAuth 浏览器流程。它会在内存中使用刷新令牌换取访问令牌，在访问令牌过期前一分钟续期，并且只会在内存中保留 Amazon 返回的任何刷新令牌。刷新令牌被撤销或过期后，请重新授权、更新变量并重启服务器。

Claude Desktop 配置项示例如下：

{
  "mcpServers": {
    "amazon-ads": {
      "command": "npx",
      "args": ["-y", "@getmcpads/amazon-ads-mcp-server"],
      "env": {
        "AMAZON_ADS_CLIENT_ID": "amzn1.application-oa2-client.your-client-id",
        "AMAZON_ADS_CLIENT_SECRET": "your-client-secret",
        "AMAZON_ADS_REFRESH_TOKEN": "Atzr|your-refresh-token",
        "AMAZON_ADS_REGION": "EU",
        "AMAZON_ADS_PROFILE_IDS": "1234567890"
      }
    }
  }
}

使用源码安装时，请将 npx 及其参数替换为 node 和 dist/cli.js 的绝对路径。运行 npm run doctor 可在不联系 Amazon 的情况下检查配置；该命令绝不会打印任何值。

安全性与覆盖范围

默认以预览方式执行写入。大多数写入操作都会返回一个 previewToken，该令牌与确切的变更以及预览时从 Amazon 读取的实体绑定。在十分钟内使用 confirm: true 和该令牌重复调用。如果请求、实体发生变化，或令牌过期，操作会在发送任何内容之前被拒绝。amazon_ads_update_campaign_status 改用其预览中的 expectedStatus，而重命名工具只需 confirm: true。

新建的 Sponsored Products 广告活动、广告组、商品广告、关键词和定向均为暂停状态。Sponsored Brands 和 Display 的创建操作若包含状态字段，必须设为暂停；若不包含状态字段，则必须有一个暂停状态的父级实体。否定关键词和否定定向会默认启用，因为它们会抑制流量。对于会开始投放的变更，预览会标记 activationMaySpend。归档操作不可撤销。

HTTP 207 响应中只要有任何项目报错，就会报告为失败。结果不确定的变更绝不会自动重试；应先读取实体并核对。读取操作收到 HTTP 401 时，会续期访问令牌一次并重试；变更操作不会这样处理。HTTP 429 响应会报告 Amazon 的 Retry-After 值，且不会重试。

每次请求前都会检查配置文件允许列表，amazon_ads_list_profiles 只返回允许列表中的配置文件。未知参数会被拒绝。金额使用配置文件的货币单位，而非微单位。较大的整数 ID 会保留为字符串，以免丢失数字。配置列表只返回一页，并通过 partial 说明这一点；请继续使用 nextToken 或 nextStartIndex 获取后续内容。

报告采用异步方式生成。amazon_ads_create_report 会返回 jobToken；约 30 秒后调用 amazon_ads_get_report。报告处于待处理状态并不代表账户为空。Sponsored Products 的购买量和销售额使用你选择的点击归因窗口。Brands 和 Display 使用其原生的 14 天归因窗口。报告文件和素材上传使用 Amazon S3 签名 URL；这些 URL 必须指向 HTTPS S3 主机，获取时不会使用任何 Amazon 凭证，也绝不会跟随重定向。

此服务涵盖 Sponsored Products、Sponsored Brands、Sponsored Display、Reporting v3、创意素材库和商品元数据。不涵盖 DSP、Amazon Marketing Cloud、账单、账户管理或投资组合。托管式创意图库、提醒、导出、广告活动启动器和 MCP Apps UI 均不在范围内。请使用 tools/list、server-card.json 或 amazon-ads://write-contracts 资源查看确切的架构，并参阅 Amazon 的 API 参考了解提供方详情。

Amazon 自有的 MCP 服务

Amazon 于 2026 年 2 月 2 日宣布 Amazon Ads MCP Server 开放 Beta 测试，面向拥有有效 API 凭证的 Amazon Ads 合作伙伴。以下比较仅使用 Amazon 自有页面：公告、概览、连接到 Amazon Ads MCP Server、Lite 版本、使用 OAuth 2.1 连接以及 MCP 工具参考，信息截至 2026 年 10 月 23 日。

	Amazon Ads MCP Server	本服务
运行位置	由 Amazon 托管在区域端点，例如 https://advertising-ai.amazon.com/mcp，由 Amazon Ads 构建并更新。	在你的计算机上通过 stdio 运行，并直接调用 Amazon Ads API。
凭证	在请求标头中提供 Login with Amazon 访问令牌和客户端 ID，或通过浏览器登录使用 OAuth 2.1。	在环境变量中配置客户端 ID、客户端密钥和刷新令牌。访问令牌会在内存中续期。
账户选择	动态模式由助手提供账户标识符；固定模式则由标头指定一个账户。	在一个区域内使用固定的配置文件 ID 允许列表，并在每次请求前进行检查。
覆盖范围	提供账户管理、广告活动管理、报告、结算、Amazon Marketing Cloud、资格、用户等工具组，以及技能和包含三个发现工具的 Lite 版本。	包含 Sponsored Products、Brands 和 Display 实体、Reporting v3、创意素材库和产品元数据，共有 108 个独立工具。
写入操作	广告活动管理工具支持创建、更新和删除。Amazon 的指南展示了如何在 Kiro CLI 配置中禁用单个工具，例如 delete_campaign。	默认关闭，除非设置 AMAZON_ADS_ENABLE_WRITES=true。每次写入前都会先预览；新广告活动、广告组和广告均会以暂停状态创建。

如果要使用本服务未涵盖的 DSP、Amazon Marketing Cloud、结算或账户管理，请使用 Amazon 的服务。

托管选项

getmcpads for Amazon Ads 管理托管连接和账户选择。 托管版本与源代码版本可能有所不同。联系方式：[email protected]。

开发

npm run typecheck
npm run lint
npm run build
npm test
npm run catalog

所有测试均使用模拟的 fetch 和合成响应离线运行。不会读取或更改任何真实账户。

工具

下方列出所有工具。完整的参数和输出架构请参阅 server-card.json。

31 个读取工具

配置文件

工具	用途
amazon_ads_list_profiles	列出这些凭证在 AMAZON_ADS_REGION 中可访问的 AMAZON_ADS_PROFILE_IDS 里的广告配置文件，并显示市场、账户类型、货币和时区。
amazon_ads_get_profile	读取所选 Amazon Ads 配置文件：市场、账户类型、货币和时区。

Sponsored Products 配置

工具	用途
amazon_ads_get_campaigns	读取一页 Amazon Sponsored Products 广告活动，默认包含已暂停和已归档的实体。
amazon_ads_get_ad_groups	读取一页 Amazon Sponsored Products 广告组，默认包含已暂停和已归档的实体。
amazon_ads_get_product_ads	读取一页 Amazon Sponsored Products 商品广告，默认包含已暂停和已归档的实体。
amazon_ads_get_keywords	读取一页 Amazon Sponsored Products 关键词，默认包含已暂停和已归档的实体。
amazon_ads_get_targets	读取一页 Amazon Sponsored Products 投放目标，默认包含已暂停和已归档的实体。
amazon_ads_get_negative_keywords	读取一页 Amazon Sponsored Products 否定关键词，默认包含已暂停和已归档的实体。
amazon_ads_get_negative_targets	读取一页 Amazon Sponsored Products 否定投放目标，默认包含已暂停和已归档的实体。
amazon_ads_get_campaign_negative_keywords	读取一页 Amazon Sponsored Products 广告活动否定关键词，默认包含已暂停和已归档的实体。
amazon_ads_get_campaign_negative_targets	读取一页 Amazon Sponsored Products 广告活动否定投放目标，默认包含已暂停和已归档的实体。

Sponsored Brands 配置

工具	用途
amazon_ads_get_brands	列出所选资料中符合 Sponsored Brands 投放条件的品牌。
amazon_ads_get_sb_campaigns	读取一页 Sponsored Brands 广告活动。
amazon_ads_get_sb_ad_groups	读取一页 Sponsored Brands 广告组。
amazon_ads_get_sb_ads	读取一页 Sponsored Brands 广告。
amazon_ads_get_sb_ad_creatives	读取某个广告的原生 Sponsored Brands 创意版本：标题、ASIN、品牌徽标以及图片或视频素材引用。
amazon_ads_get_sb_keywords	列出一页 Sponsored Brands 关键词，包括已归档的实体。
amazon_ads_get_sb_negative_keywords	列出一页 Sponsored Brands 否定关键词，包括已归档的实体。
amazon_ads_get_sb_targets	列出一页 Sponsored Brands 投放目标，包括已归档的实体。
amazon_ads_get_sb_negative_targets	列出一页 Sponsored Brands 否定投放目标，包括已归档的实体。

Sponsored Display 配置

工具	用途
amazon_ads_get_sd_campaigns	读取一页 Sponsored Display 广告活动。
amazon_ads_get_sd_ad_groups	读取一页 Sponsored Display 广告组。
amazon_ads_get_sd_product_ads	读取一页 Sponsored Display 商品广告。
amazon_ads_get_sd_targets	读取一页 Sponsored Display 投放目标。
amazon_ads_get_sd_negative_targets	读取一页 Sponsored Display 否定投放目标。
amazon_ads_get_sd_creatives	读取一页 Sponsored Display 创意。

报告

工具	用途
amazon_ads_create_report	请求异步 Amazon 效果报告：Sponsored Products 广告活动、广告组、展示位置、搜索词或推广商品；Brands 广告活动、广告或搜索词；Display 广告活动或商品。
amazon_ads_get_report	查询一次 Amazon 报告，并在报告完成后读取其原生数据行。

创意素材与商品目录

工具	用途
amazon_ads_list_creative_assets	搜索 Amazon 创意素材库：图片、徽标和视频、原生下载或播放 URL、尺寸及审核元数据。
amazon_ads_get_creative_asset	刷新所选资料中的一个原生 Amazon 图片或视频素材。
amazon_ads_get_product_metadata	从广告主的 Amazon 商品目录中读取推广商品标题、原生图片 URL、库存、价格和投放资格。

77 个写入工具

仅在设置 `AMAZON_ADS_ENABLE_WRITES=true` 时注册。除非传入 `confirm: true`，否则每次调用都会先预览；大多数写入操作还需要使用预览中的 `previewToken`。

Sponsored Products

工具	用途
amazon_ads_create_campaign	创建一个处于 PAUSED 状态的 Sponsored Products 广告活动。
amazon_ads_update_campaign	更新 Sponsored Products 广告活动的名称、状态、日期或竞价策略。
amazon_ads_update_campaign_budget	更改一个 Sponsored Products 每日预算，金额使用档案币种。
amazon_ads_update_campaign_status	暂停或启用一个 Amazon Sponsored Products 广告活动。
amazon_ads_create_ad_group	创建一个处于 PAUSED 状态的 Sponsored Products 广告组，并设置档案币种的默认竞价。
amazon_ads_update_ad_group	更新一个 Sponsored Products 广告组的状态和竞价。
amazon_ads_create_product_ad	创建一个 Sponsored Products 商品广告。
amazon_ads_update_product_ad	更新一个 Sponsored Products 商品广告的状态。
amazon_ads_create_keyword	创建一个 Sponsored Products 关键词。
amazon_ads_update_keyword	更新一个 Sponsored Products 关键词的状态和竞价。
amazon_ads_create_target	创建一个 Sponsored Products 投放目标。
amazon_ads_update_target	更新一个 Sponsored Products 投放目标的状态和竞价。
amazon_ads_create_negative_keyword	创建一个 Sponsored Products 否定关键词。
amazon_ads_update_negative_keyword	更改一个 Sponsored Products 否定关键词的状态。
amazon_ads_create_negative_target	创建一个 Sponsored Products 否定投放目标。
amazon_ads_update_negative_target	更改一个 Sponsored Products 否定投放目标的状态。
amazon_ads_create_campaign_negative_keyword	创建一个 Sponsored Products 广告活动否定关键词。
amazon_ads_update_campaign_negative_keyword	更改一个 Sponsored Products 广告活动否定关键词的状态。
amazon_ads_create_campaign_negative_target	创建一个 Sponsored Products 广告活动否定投放目标。
amazon_ads_update_campaign_negative_target	更改一个 Sponsored Products 广告活动否定投放目标的状态。

Sponsored Brands

工具	用途
amazon_ads_create_sb_campaign	创建一个 Sponsored Brands 广告活动。
amazon_ads_update_sb_campaign	更新一个 Sponsored Brands 广告活动。
amazon_ads_create_sb_ad_group	创建一个 Sponsored Brands 广告组。
amazon_ads_update_sb_ad_group	更新一个 Sponsored Brands 广告组。
amazon_ads_update_sb_ad	更新一个 Sponsored Brands 广告。
amazon_ads_create_sb_ad_product_collection	创建一个 Sponsored Brands 商品集广告。
amazon_ads_create_sb_ad_product_collection_extended	创建一个 Sponsored Brands 扩展商品集广告。
amazon_ads_create_sb_ad_video	创建一个 Sponsored Brands 视频广告。
amazon_ads_create_sb_ad_brand_video	创建一个 Sponsored Brands 品牌视频广告。
amazon_ads_create_sb_ad_store_spotlight	创建一个 Sponsored Brands 店铺聚焦广告。
amazon_ads_create_sb_ad_auto_collection	创建一个 Sponsored Brands 自动商品集广告。
amazon_ads_create_sb_ad_manual_collection	创建一个 Sponsored Brands 手动商品集广告。
amazon_ads_update_sb_ad_creative_product_collection	替换一个 Sponsored Brands 商品集广告的创意素材。
amazon_ads_update_sb_ad_creative_product_collection_extended	替换一个 Sponsored Brands 扩展商品集广告的创意素材。
amazon_ads_update_sb_ad_creative_video	替换一个 Sponsored Brands 视频广告的创意素材。
amazon_ads_update_sb_ad_creative_brand_video	替换一个 Sponsored Brands 品牌视频广告的创意素材。
amazon_ads_update_sb_ad_creative_store_spotlight	替换一个 Sponsored Brands 店铺聚焦广告的创意素材。
amazon_ads_update_sb_ad_creative_auto_collection	替换一个 Sponsored Brands 自动商品集广告的创意素材。
amazon_ads_update_sb_ad_creative_manual_collection	替换一个 Sponsored Brands 手动商品集广告的创意素材。
amazon_ads_create_sb_keyword	创建一个 Sponsored Brands 关键词。
amazon_ads_update_sb_keyword	更新一个 Sponsored Brands 关键词。
amazon_ads_create_sb_negative_keyword	创建一个 Sponsored Brands 否定关键词。
amazon_ads_update_sb_negative_keyword	更新一个 Sponsored Brands 否定关键词。
amazon_ads_create_sb_target	创建一个 Sponsored Brands定向。
amazon_ads_update_sb_target	更新一个 Sponsored Brands 定向。
amazon_ads_create_sb_negative_target	创建一个 Sponsored Brands 否定定向。
amazon_ads_update_sb_negative_target	更新一个 Sponsored Brands 否定定向。

Sponsored Display

工具	用途
amazon_ads_create_sd_campaign	创建一个 Sponsored Display 广告活动。
amazon_ads_update_sd_campaign	更新一个 Sponsored Display 广告活动。
amazon_ads_create_sd_ad_group	创建一个 Sponsored Display 广告组。
amazon_ads_update_sd_ad_group	更新一个 Sponsored Display 广告组。
amazon_ads_create_sd_product_ad	创建一个 Sponsored Display 商品广告。
amazon_ads_update_sd_product_ad	更新一个 Sponsored Display 商品广告。
amazon_ads_create_sd_target	创建一个 Sponsored Display 定向。
amazon_ads_update_sd_target	更新一个 Sponsored Display 定向。
amazon_ads_create_sd_negative_target	创建一个 Sponsored Display 否定定向。
amazon_ads_update_sd_negative_target	更新一个 Sponsored Display 否定定向。
amazon_ads_create_sd_creative	创建一个 Sponsored Display 创意素材。
amazon_ads_update_sd_creative	更新一个 Sponsored Display 创意素材。

归档（不可逆）

工具	用途
amazon_ads_archive_sb_campaign	永久归档一个 Sponsored Brands 广告活动。
amazon_ads_archive_sb_ad_group	永久归档一个 Sponsored Brands 广告组。
amazon_ads_archive_sb_ad	永久归档一个 Sponsored Brands 广告。
amazon_ads_archive_sb_keyword	永久归档一个 Sponsored Brands 关键词。
amazon_ads_archive_sb_negative_keyword	永久归档一个 Sponsored Brands 否定关键词。
amazon_ads_archive_sb_target	永久归档一个 Sponsored Brands 定向对象。
amazon_ads_archive_sb_negative_target	永久归档一个 Sponsored Brands 否定定向对象。
amazon_ads_archive_sd_campaign	永久归档一个 Sponsored Display 广告活动。
amazon_ads_archive_sd_ad_group	永久归档一个 Sponsored Display 广告组。
amazon_ads_archive_sd_product_ad	永久归档一个 Sponsored Display 商品广告。
amazon_ads_archive_sd_target	永久归档一个 Sponsored Display 定向对象。
amazon_ads_archive_sd_negative_target	永久归档一个 Sponsored Display 否定定向对象。

创意素材上传

工具	用途
amazon_ads_prepare_asset_upload	为此配置文件准备 Amazon 图片或视频上传。
amazon_ads_upload_asset_bytes	将提供的图片或视频字节上传到与 amazon_ads_prepare_asset_upload 返回的不透明 uploadToken 绑定的原生 S3 URL。
amazon_ads_register_uploaded_asset	注册已上传到 amazon_ads_prepare_asset_upload 返回的 Amazon URL 的字节。

重命名

工具	用途
amazon_ads_rename_campaign	重命名一个 Amazon Sponsored Products、Brands 或 Display 广告活动。
amazon_ads_rename_ad_group	重命名一个 Amazon Sponsored Products、Brands 或 Display 广告组。
amazon_ads_rename_ad	重命名一个 Amazon Sponsored Brands 广告。

资源

资源	内容
amazon-ads://guide	范围、分页、归因、预览和确认规则，以及重命名矩阵。
amazon-ads://report-catalog	amazon_ads_create_report 使用的报告类型、指标列和分组字段。
amazon-ads://write-contracts	支撑 Sponsored Brands 和 Display 写入工具的 39 个固定 Amazon 请求契约。

许可证

Apache License 2.0。请参阅 NOTICE。

来自 getmcpads 的更多内容

Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads

由 getmcpads 的 Emmanuel 维护。有问题请联系：[email protected]。