连接器指南阅读约 3 分钟10 个 MCP 工具7 种语言

如何通过 MCP 将 Amazon Ads 连接到 Cursor

读取 Amazon Ads(Sponsored Products)账户:广告配置文件、广告活动、广告组、商品广告、关键词、否定关键词和投放目标,并为 Sponsored Products、Brands 和 Display 请求 Reporting v3 效果报告。适用于 NA、EU 和 FE 区域的卖家、供应商和代理商。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Amazon Ads

Amazon Ads

Read Amazon Ads (Sponsored Products) accounts: advertising profiles, campaigns, ad groups, product ads, keywords, negative keywords and targets, and request Reporting v3 performance reports for Sponsored Products, Brands and Display. For sellers, vendors and agencies, in the NA, EU and FE regions.

个工具

10

区域

INTL

类别

广告

身份验证

OAuth 2.0

所需环境变量

AMAZON_ADS_CLIENT_IDAMAZON_ADS_CLIENT_SECRETAMAZON_ADS_API_URLAMAZON_ADS_AUTHORIZATION_URLAMAZON_ADS_TOKEN_URL
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 Amazon Ads,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

读取 Amazon Ads(Sponsored Products)账户:广告配置文件、广告活动、广告组、商品广告、关键词、否定关键词和投放目标,并为 Sponsored Products、Brands 和 Display 请求 Reporting v3 效果报告。适用于 NA、EU 和 FE 区域的卖家、供应商和代理商。

试试这样问

Amazon Ads 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Amazon Ads · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Amazon Ads、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无 git clone、无本地服务器。

Amazon Ads + Cursor

读取 Amazon Ads(Sponsored Products)账户:广告配置文件、广告活动、广告组、商品广告、关键词、否定关键词和投放目标,并为 Sponsored Products、Brands 和 Display 请求 Reporting v3 效果报告。适用于 NA、EU 和 FE 区域的卖家、供应商和代理商。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

AMAZON_ADS_CLIENT_ID, AMAZON_ADS_CLIENT_SECRET, AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL, AMAZON_ADS_TOKEN_URL

步骤 1 — 获取凭证

  1. 确认你拥有 Amazon Ads API 访问权限:一个已获批的 API 应用,以及与之关联的 Login with Amazon(LWA)安全配置文件。API 访问需向 Amazon Ads 申请(Partner Network,或 https://advertising.amazon.com/API)。没有 API 批准时,登录可以完成,但 Amazon 会拒绝每一次调用。

  2. 在 LWA 控制台(https://developer.amazon.com,Login with Amazon)中打开该安全配置文件,进入 Web Settings,在 Allowed Return URLs 中添加 https://cloud.anythingmcp.com/api/mcp-oauth/callback(如果你自行托管 AnythingMCP:<your AnythingMCP URL>/api/mcp-oauth/callback)。

  3. 把同一页面上的 Client ID 和 Client Secret(Show Secret)复制到 AMAZON_ADS_CLIENT_ID 和 AMAZON_ADS_CLIENT_SECRET。客户端 ID 以 amzn1.application-oa2-client. 开头。

  4. 按你的区域依次设置 AMAZON_ADS_API_URL、AMAZON_ADS_AUTHORIZATION_URL 和 AMAZON_ADS_TOKEN_URL:

    • 北美(US、CA、MX、BR):https://advertising-api.amazon.com、https://www.amazon.com/ap/oa、https://api.amazon.com/auth/o2/token
    • 欧洲(UK、DE、FR、IT、ES、NL、SE、PL、TR、AE、SA、EG、IN):https://advertising-api-eu.amazon.com、https://eu.account.amazon.com/ap/oa、https://api.amazon.co.uk/auth/o2/token
    • 远东(JP、AU、SG):https://advertising-api-fe.amazon.com、https://apac.account.amazon.com/ap/oa、https://api.amazon.co.jp/auth/o2/token

    一个连接器只能看到所在区域的配置文件,因此如果你在多个区域投放广告,请为每个区域各安装一次。

  5. AMAZON_ADS_REFRESH_TOKEN 请留空,除非你已在别处为 Amazon Ads API 授权过这个安全配置文件(该令牌以 Atzr| 开头)。安装连接器,点击 Authorize with Provider,并用有权访问这些广告账户的 Amazon 账户登录。scope 为 advertising::campaign_management。

  6. 运行 amazon_ads_list_profiles。一个配置文件代表一个商城中的一个广告主,它的 ID 要传给其他所有工具。列表为空表示该账户在此区域没有广告账户,或从未创建过广告活动。

只读:AI 可以列出 Sponsored Products 广告活动、广告组、商品广告(被推广的 ASIN 或 SKU)、带出价和匹配类型的关键词、否定关键词,以及商品、品类和自动投放目标。

效果数据来自报告:展示次数、点击次数、花费、销售额、ACOS 和 ROAS 只能通过报告获得。amazon_ads_create_report 在 Amazon 端启动一个报告任务(不会修改任何广告活动),amazon_ads_get_report 查看其状态。报告通常几分钟内完成,但在高峰时段可能需要长达一小时。大多数报告类型可回溯 95 天,DAILY 报告最多覆盖 31 天。Sponsored Brands 和 Sponsored Display 的广告活动不会被列出,但可以通过报告获取它们的效果数据。

报告文件:完成的报告是一个指向 gzip 压缩 JSON 文件的下载链接,有效期约一小时。连接器无法解压该文件,所以 AI 会把链接交给你,由你自己下载并打开,或交给能解压它的工具。花费以配置文件的币种显示。

限制和错误:Amazon 按账户和接口限流,并返回 429 以及重试前需要等待的时间。访问令牌有效期为一小时,会自动续期。401:请重新授权,并检查客户端 ID、登录 URL 和令牌 URL 是否与 API 端点属于同一区域。403:该 Amazon 账户无权访问这个配置文件,或安全配置文件未获准使用 Amazon Ads API。425:同一份报告已经请求过,响应中会带有它的 ID。

该连接器不会创建或修改广告活动、出价或预算,也不会列出 Sponsored Brands 或 Sponsored Display 广告活动。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 Cursor。
  3. 打开 Cursor → Settings → MCP,确认 anythingmcp 已列出并处于已连接状态。
  4. 开始对话,智能体现在可以调用 Amazon Ads 的工具。

可用工具

ToolWhat it does
amazon_ads_list_profilesList the advertising profiles the authorized Amazon account can reach in this region: profileId, countryCode, currencyCode, timezone…
amazon_ads_get_profileGet one advertising profile by id: marketplace (countryCode), currency, timezone, daily budget and the account it belongs to
amazon_ads_list_sp_campaignsList Sponsored Products campaigns of a profile: campaignId, name, state, targetingType (MANUAL or AUTO), budget, bidding strategy and…
amazon_ads_list_sp_ad_groupsList Sponsored Products ad groups of a profile with adGroupId, campaignId, name, state and default bid
amazon_ads_list_sp_product_adsList Sponsored Products product ads (the advertised ASINs or SKUs) with adId, adGroupId, campaignId, asin, sku and state
amazon_ads_list_sp_keywordsList Sponsored Products keywords with keywordId, adGroupId, campaignId, keywordText, matchType (EXACT, PHRASE, BROAD), bid and state
amazon_ads_list_sp_negative_keywordsList Sponsored Products ad-group negative keywords with keywordId, adGroupId, campaignId, keywordText, matchType (NEGATIVE_EXACT…
amazon_ads_list_sp_targetsList Sponsored Products targeting clauses (product, category and auto targets) with targetId, adGroupId, campaignId, expression…
amazon_ads_create_reportRequest an asynchronous performance report (Reporting v3) and get back its reportId with status PENDING
amazon_ads_get_reportGet the status of a report requested with amazon_ads_create_report: PENDING, PROCESSING, COMPLETED or FAILED (with failureReason)

示例提示

  • “列出我们的广告配置文件,以及各自的商城和币种。”
  • “请求一份过去 30 天按广告活动划分的 Sponsored Products 报告,完成后把下载链接给我。”
  • “我们的手动广告活动中哪些关键词使用广泛匹配?它们的出价是多少?”
  • “显示我们最大广告活动的否定关键词,方便我在添加新词前检查有哪些遗漏。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗? 支持,Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

这份指南对你有帮助吗?

你的 Amazon Ads 智能体只差一次点击。

安装连接器,粘贴密钥,向 Cursor 提问。免费试用 7 天,无需信用卡。

相关指南

连接器

Amazon Ads 接入 MCP:从任意 AI 代理驱动 Amazon Ads

读取 Amazon Ads(Sponsored Products)账户:广告配置文件、广告活动、广告组、商品广告、关键词、否定关键词和投放目标,并为 Sponsored Products、Brands 和 Display 请求 Reporting v3 效果报告。适用于 NA、EU 和 FE 区域的卖家、供应商和代理商。

连接器

如何通过 MCP 将 Amazon Ads 连接到 ChatGPT

读取 Amazon Ads(Sponsored Products)账户:广告配置文件、广告活动、广告组、商品广告、关键词、否定关键词和投放目标,并为 Sponsored Products、Brands 和 Display 请求 Reporting v3 效果报告。适用于 NA、EU 和 FE 区域的卖家、供应商和代理商。

连接器

如何通过 MCP 将 Amazon Ads 连接到 Claude

读取 Amazon Ads(Sponsored Products)账户:广告配置文件、广告活动、广告组、商品广告、关键词、否定关键词和投放目标,并为 Sponsored Products、Brands 和 Display 请求 Reporting v3 效果报告。适用于 NA、EU 和 FE 区域的卖家、供应商和代理商。

连接器

如何通过 MCP 将 Amazon Ads 连接到 Gemini

读取 Amazon Ads(Sponsored Products)账户:广告配置文件、广告活动、广告组、商品广告、关键词、否定关键词和投放目标,并为 Sponsored Products、Brands 和 Display 请求 Reporting v3 效果报告。适用于 NA、EU 和 FE 区域的卖家、供应商和代理商。

连接器

如何通过 MCP 将 Amazon Ads 连接到 Meta Muse

读取 Amazon Ads(Sponsored Products)账户:广告配置文件、广告活动、广告组、商品广告、关键词、否定关键词和投放目标,并为 Sponsored Products、Brands 和 Display 请求 Reporting v3 效果报告。适用于 NA、EU 和 FE 区域的卖家、供应商和代理商。

连接器

如何通过 MCP 将 Archer IRM 连接到 Cursor

通过 REST API 和 Content API 读取 Archer IRM(原 RSA Archer)的 GRC 数据:应用、层级、字段和值列表,以及用 OData 搜索的风险、控制、发现项和事件记录。使用 Archer 账户进行会话登录。