amazon_ads_mcp - 開源SDK支持多區域和全API覆蓋，實現AI應用與亞馬遜廣告API安全交互

探索

Amazon Ads MCP

Amazon Ads API MCP SDK是一個開源工具包，通過Model Context Protocol讓AI應用能夠安全地與亞馬遜廣告API交互，支持多區域、全面的API覆蓋，用於構建AI驅動的廣告管理應用。

營銷人工智能聊天機器人 #廣告管理 #AI集成 #API工具 #營銷自動化 .Python

評分 : 2.5分

下載量 : 4.2K

更新時間 : 2025-10-09

打開站點

什麼是Amazon Ads MCP SDK?

這是一個開源工具包，讓AI助手能夠與亞馬遜廣告API安全交互。它充當AI模型與亞馬遜廣告系統之間的翻譯器，提供結構化的操作接口，防止AI隨意操作造成問題。

如何使用Amazon Ads MCP?

通過配置MCP客戶端(如Claude Desktop)連接到服務器，然後使用自然語言管理廣告活動、查看報告、優化預算等。系統提供安全的OAuth認證流程。

適用場景

營銷聊天機器人、自動化廣告管理、智能預算優化、創意測試分析、即時性能監控、多賬戶廣告管理等場景。

主要功能

MCP協議集成

完全兼容Model Context Protocol，可與各種AI助手無縫集成

多區域支持

支持北美(NA)、歐洲(EU)、遠東(FE)三個區域的亞馬遜廣告API端點

完整API覆蓋

覆蓋廣告活動管理、報告分析、DSP、AMC工作流等所有主要亞馬遜廣告服務

類型安全

基於Pydantic的完整類型提示和驗證，確保操作安全可靠

生產就緒

包含測試、驗證和錯誤處理，適合生產環境部署

Docker支持

提供Docker鏡像，簡化部署和運行過程

優勢

讓非技術用戶也能通過自然語言管理複雜廣告操作

提供安全的操作邊界，防止AI誤操作

支持多種認證方式，包括OAuth和令牌認證

完整的API覆蓋，滿足各種廣告管理需求

易於集成到現有AI助手和工作流中

侷限性

需要基本的亞馬遜廣告API知識來配置認證

工具數量較多時可能影響AI助手的上下文限制

區域和賬戶配置需要手動設置

依賴穩定的網絡連接訪問亞馬遜API

如何使用

安裝Docker環境

確保系統已安裝Docker和Docker Compose，這是運行MCP服務器的最簡單方式

配置環境變量

複製環境模板文件並配置您的亞馬遜廣告API憑證

啟動服務器

使用Docker Compose啟動MCP服務器

配置AI客戶端

在Claude Desktop或其他MCP客戶端中配置服務器連接

完成OAuth認證

通過AI助手啟動OAuth流程，授權訪問您的亞馬遜廣告賬戶

使用案例

廣告活動管理

通過自然語言創建、修改和監控廣告活動

性能分析

獲取廣告表現數據並進行分析

預算優化

基於表現數據調整廣告預算

多賬戶管理

管理多個廣告賬戶的活動

常見問題

我需要編程知識才能使用這個工具嗎？

這個工具安全嗎？會誤操作我的廣告賬戶嗎？

支持哪些亞馬遜廣告類型？

如何獲取亞馬遜廣告API訪問權限？

工具數量太多會影響AI性能嗎？

支持哪些AI客戶端？

安裝

複製以下命令到你的Client進行配置

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://${HOSTNAME}:${PORT}/mcp/",
        "--allow-http",
        "--header",
        "Authorization:Bearer ${OPENBRIDGE_REFRESH_TOKEN}",
        "--header",
        "Accept:application/json,text/event-stream",
        "--debug"
      ],
      "env": {
        "MCP_TIMEOUT": "300",
        "HOSTNAME": "your_hostname",
        "PORT": "your_server_port",
        "MCP_TIMEOUT": "120000",
        "MCP_REQUEST_TIMEOUT": "60000",
        "MCP_CONNECTION_TIMEOUT": "10000",
        "MCP_SERVER_REQUEST_TIMEOUT": "60000",
        "MCP_TOOL_TIMEOUT": "120000",
        "MCP_REQUEST_WARNING_THRESHOLD": "10000",
        "OPENBRIDGE_REFRESH_TOKEN": "your_openbridge_token_here"
      }
    }
  }
}

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://${HOSTNAME}:${PORT}/mcp/",
        "--allow-http",
        "--header",
        "Authorization:${AUTH_HEADER}"
        "--header",
        "Accept: application/json, text/event-stream"
      ],
      "env": {
        "MCP_TIMEOUT": "300",
        "HOSTNAME": "your_hostname",
        "PORT": "your_server_port",
        "MCP_TIMEOUT": "120000",
        "MCP_REQUEST_TIMEOUT": "60000",
        "MCP_CONNECTION_TIMEOUT": "10000",
        "MCP_SERVER_REQUEST_TIMEOUT": "60000",
        "MCP_TOOL_TIMEOUT": "120000",
        "MCP_REQUEST_WARNING_THRESHOLD": "10000",
        "AUTH_HEADER": "Bearer <your_openbridge_token_here>"
      }
    }
  }
}

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://localhost:9080/mcp/",
        "--allow-http"
      ],
      "env": {
        "MCP_TIMEOUT": "120000",
        "MCP_REQUEST_TIMEOUT": "60000",
        "MCP_CONNECTION_TIMEOUT": "10000",
        "MCP_SERVER_REQUEST_TIMEOUT": "60000",
        "MCP_TOOL_TIMEOUT": "120000",
        "MCP_REQUEST_WARNING_THRESHOLD": "10000"
      }
    }
  }
}

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

🚀 Amazon Ads API MCP SDK

藉助適用於亞馬遜廣告API的模型上下文協議（MCP）SDK，構建由人工智能驅動的廣告應用程序

由 Openbridge 用心 + 咖啡打造

🚀 快速開始

MCP工具是什麼？

可以將MCP（模型上下文協議）視為人工智能模型與外部系統（如亞馬遜廣告）之間的翻譯器。每個MCP工具就像一個遙控器按鈕，指示人工智能如何與亞馬遜廣告進行交互。如果沒有MCP工具，人工智能將不知道如何與亞馬遜廣告“對話”。

藉助MCP工具：

人工智能知道要調用的確切端點。
人工智能可以安全地請求廣告活動報告、預算或定位數據。
一切都有結構，因此人工智能不會通過隨機猜測而導致問題。

👉 簡而言之：MCP工具是一個安全、標註清晰的工具包，使人工智能能夠使用亞馬遜廣告API 開展工作。

什麼是Amazon Ads API MCP SDK？

Amazon Ads API MCP SDK是一個開源實現，為創建由人工智能驅動的廣告工具、聊天機器人和自動化服務提供了強大的基礎。

✨ 主要特性

🔌 MCP集成：完全符合模型上下文協議，便於人工智能應用程序集成。
🌍 多區域支持：支持北美、歐洲和遠東地區的端點，並可自動路由。
📊 全面的API覆蓋：涵蓋廣告活動、廣告資源、報告、DSP、AMC工作流程等。
📝 類型安全：全面支持Pydantic模型，並提供詳細的類型提示。
🧪 生產就緒：包含測試、驗證和錯誤處理功能。

🎯 使用場景

Claude桌面集成

廣告活動管理：讓Claude創建、更新或分析廣告活動。
性能洞察：獲取由人工智能驅動的廣告性能分析。
預算優化：讓Claude根據性能建議調整預算。
創意測試：獲取廣告創意改進建議。
報告：按需生成自定義報告和洞察。

人工智能應用程序

營銷聊天機器人：構建能夠管理亞馬遜廣告活動的對話式人工智能。
自動報告：由人工智能驅動的廣告性能分析和洞察。
智能預算管理：使用人工智能進行智能預算優化。
創意優化：由人工智能驅動的廣告創意測試和優化。

企業服務

營銷自動化平臺：將亞馬遜廣告集成到現有的營銷工具中。
代理管理系統：多客戶、多賬戶廣告管理。
電子商務集成：將亞馬遜廣告與電子商務平臺連接起來。
分析儀表盤：即時監控廣告性能。

開發工具

API包裝器：為特定用例創建自定義SDK。
測試框架：對亞馬遜廣告集成進行自動化測試。
開發工具：本地開發和調試工具。

📚 Amazon Ads MCP包含哪些內容？

MCP服務器廣泛覆蓋了亞馬遜廣告API中發佈的內容。每個部分都與亞馬遜廣告API中的一組操作相對應。這包括諸如新亞馬遜廣告API v1中的廣告活動管理服務、導出、亞馬遜營銷雲等服務。

以下是MCP中各種亞馬遜API服務的代表性列表：

賬戶
受眾
報告
品牌指標
贊助商品
贊助品牌
贊助展示
亞馬遜DSP
亞馬遜歸因
推薦與洞察
創意素材
更改歷史記錄
數據提供商
商品
統一預審核
審核
亞馬遜營銷流
位置
導出
媒體規劃

📦 安裝指南

我們建議使用 🐳 Docker 安裝Amazon Ads API MCP：

docker pull openbridge/amazon-ads-mcp

複製環境模板：

cp .env.example .env

使用您的設置編輯 .env 文件。

使用Docker Compose啟動服務器：

docker-compose up -d

服務器將在 http://localhost:9080 上可用。

查看日誌：

docker-compose logs -f

停止服務器：

docker-compose down

有關完整的安裝說明，包括驗證、升級和開發人員設置，請參閱。

配置

亞馬遜廣告要求所有對API的調用都經過授權。如果您不確定這意味著什麼，您應該閱讀亞馬遜的文檔：

亞馬遜廣告API入門概述：https://advertising.amazon.com/API/docs/en-us/guides/onboarding/overview
亞馬遜廣告API入門：https://advertising.amazon.com/API/docs/en-us/guides/get-started/overview

連接到API有兩種途徑：

自帶應用程序（BYOA）
利用合作伙伴應用程序

自帶亞馬遜廣告API應用程序

如果您有自己的亞馬遜廣告API應用程序，或者想創建一個，以下是詳細的流程。

1. 在亞馬遜註冊您的應用程序

訪問亞馬遜開發者控制檯。
創建或選擇您的“使用亞馬遜登錄”應用程序。
記錄您的 客戶端ID 和 客戶端密鑰。
將您的回調URL設置為“允許的返回URL”。這是您運行此服務器的位置：
- 生產環境：https://your-server.com/auth/callback
- 本地開發環境：http://localhost:8000/auth/callback

一旦您的應用程序獲得亞馬遜的安全批准，您將需要客戶端ID和密鑰：

# 亞馬遜廣告API憑證（必需）
AMAZON_AD_API_CLIENT_ID="your-client-id"
AMAZON_AD_API_CLIENT_SECRET="your-client-secret"

確保這些信息在您的 .env 文件中。此外，確保在同一個 .env 文件中將授權方法設置為 direct：

AUTH_METHOD=direct

完成OAuth流程

要授權您與亞馬遜的連接，您需要作為最終用戶完成OAuth工作流程。首先，您需要設置您的區域。授權是在區域級別進行的，如果不設置區域可能會導致失敗。服務器默認區域為 na。您可以使用工具 set_active_region 手動設置區域。

工具：set_active_region
參數：na | eu | fe

示例提示："Set my current region to eu"

步驟1：啟動OAuth

要連接到亞馬遜廣告API，您可以使用MCP工具啟動OAuth流程。

工具：start_oauth_flow
示例提示："Start my OAuth flow"

步驟2：重定向到亞馬遜廣告

在這個示例中，您會收到提示，點擊鏈接將打開一個瀏覽器窗口，並請求在亞馬遜上進行批准。

步驟3：批准請求

在瀏覽器窗口中，亞馬遜會提示您批准連接請求。

步驟4：成功

如果一切順利，您將看到成功響應。您可以關閉瀏覽器窗口並返回客戶端。如果看到其他內容，請再次嘗試該過程，並確認所有配置元素都正確。

步驟5：確認

要確認您的MCP服務器已連接到亞馬遜廣告API，請檢查您的OAuth狀態。

工具：check_oauth_status
示例提示："Check my OAuth status"

現在您可以開始與亞馬遜廣告API系統進行交互了！

合作伙伴應用程序：令牌認證

您可以配置您的客戶端（如Claude），通過提供有效的訪問令牌來進行認證。這適用於服務賬戶、長期有效的API密鑰、CI/CD、認證單獨管理的應用程序或其他非交互式認證方法。

Openbridge合作伙伴應用程序

作為廣告API合作伙伴應用程序提供商，Openbridge提供了一個現成的網關來訪問亞馬遜廣告API。您登錄到Openbridge賬戶，生成一個令牌，然後在客戶端配置中設置該令牌（見下文）。

首先，將Openbridge設置為認證方法：

AUTH_METHOD=openbridge

服務器配置就完成了。要訪問服務器，您需要配置客戶端（如Claude Desktop）直接傳遞令牌。（請參閱示例MCP客戶端：連接Claude Desktop）

授權的亞馬遜賬戶

您的亞馬遜授權信息存儲在Openbridge中。在客戶端中的第一步是請求您當前的身份："List my remote identities"。接下來，您可以告訴MCP服務器使用其中一個身份："Set my remote identity to <>"。然後，您可以要求MCP列出與該賬戶關聯的所有亞馬遜廣告資源："List all of my Amazon Ad profiles"。如果您沒有看到列出的廣告商，請設置不同的身份。

設置您的亞馬遜廣告MCP包

要激活，您需要設置一個以逗號分隔的包來加載。例如，要激活 profiles 和 amc-workflow，請按如下方式設置您的包環境：

AMAZON_AD_API_PACKAGES="profiles,amc-workflow"

以下是服務器中可用的工具包列表：

profiles
campaign-manage
accounts-manager-accounts
accounts-ads-accounts
accounts-portfolios
accounts-billing
accounts-account-budgets
audiences-discovery
reporting-version-3
brand-benchmarks
brand-metrics
stores-analytics
sponsored-products
sp-suggested-keywords
sponsored-brands-v4
sponsored-brands-v3
sponsored-display
dsp-measurement
dsp-advertisers
dsp-audiences
dsp-conversions
dsp-target-kpi-recommendations
amazon-attribution
audience-insights
forecasts
brand-store-manangement
partner-opportunities
tactical-recommendations
persona-builder
creative-assets
change-history
data-provider-data
data-provider-hashed
products-metadata
products-eligibility
unified-pre-moderation-results
moderation-results
amazon-marketing-stream
locations
exports-snapshots
marketing-mix-modeling
reach-forecasting
amc-administration
amc-workflow
amc-rule-audience
amc-ad-audience

您會注意到有些工具包被分成了更小的組。例如，亞馬遜營銷雲有多個包：amc-ad-audience、amc-administration、amc-rule-audience 和 amc-workflow。這樣做是為了提高效率和優化，減少許多人工智能客戶端中的上下文限制。

理解亞馬遜廣告MCP工具

亞馬遜廣告MCP工具帶有前綴（如 cp_ 表示廣告活動性能，amc_ 表示亞馬遜營銷雲），以幫助組織特定的廣告API操作。

示例前綴：

cp_ → 廣告活動/廣告API
amc_ → 與AMC相關的API
dsp_ → DSP API
sd_ → 贊助展示
ams_ → 亞馬遜營銷流

這將轉化為與可用的API操作相對應的工具集合：

廣告活動管理 (`cp_`)

cp_listCampaigns — 列出所有廣告活動
cp_getCampaign — 獲取特定廣告活動
cp_createCampaign — 創建新的廣告活動
cp_updateCampaign — 更新廣告活動
cp_archiveCampaign — 存檔廣告活動

贊助商品 (`sp_`)

sp_listProductAds — 列出商品廣告
sp_createKeywords — 創建關鍵詞
sp_updateBids — 更新關鍵詞出價
sp_getNegativeKeywords — 獲取否定關鍵詞

AMC工作流程 (`amc_`)

amc_listWorkflows — 列出AMC工作流程
amc_executeWorkflow — 運行工作流程
amc_getWorkflowStatus — 檢查工作流程狀態

用戶會看到如下工具：

"List my Amazon Ads campaigns"
→ Claude使用：cp_listCampaigns
"Create an AMC workflow"
→ Claude使用：amc_createWorkflow
"Export my sponsored products ads data"
→ Claude使用：export_createAdExport

廣告商資源與區域

設置您的廣告商資源

根據亞馬遜的說法：資源在亞馬遜廣告API中起著至關重要的作用，它決定了給定調用的管理範圍。資源ID是訪問特定市場中廣告商數據和服務所需的憑證。

您可能不知道您的授權可以訪問哪些資源。您可以列出您的授權可以訪問的所有廣告資源：

工具：ac_listProfiles
示例提示："List my advertiser profile ids"

響應中包含資源詳細信息：

資源ID、國家代碼、貨幣代碼
每日預算、時區
賬戶信息（類型：賣家/供應商/代理商）

假設您的列表中包含資源ID 1043817530956285。您可以通過獲取資源詳細信息來檢查更多細節，以確認這是您要使用的資源。

工具：ac_getProfile
示例提示："Get the details for my profile_id: 1043817530956285"

假設這是您要使用的資源，您需要設置亞馬遜API調用所需的資源：

工具：set_active_profile
示例提示："Set my active profile id to 1043817530956285"

當您設置資源時，它將決定：

您訪問哪個賬戶的數據
報告的貨幣和時區
可用的廣告活動/廣告/關鍵詞

資源ID將在您的會話期間在後臺設置。如果您想切換到新的資源，請重複此過程。

大多數對亞馬遜廣告API的調用都需要一個區域。每個廣告商資源ID 都與特定區域/市場中的廣告賬戶相關聯。

區域是廣告商資源的一部分。當您使用 set_active_profile 設置廣告商資源時，它將自動設置與該資源關聯的區域。

工具：set_active_profile

示例提示："Set my active advertiser profile to 111111111111"

由於資源ID 111111111111 與 na 區域相關聯，區域將根據資源區域進行設置。

設置活動區域

亞馬遜廣告MCP服務器包含用於管理API區域的工具，支持默認設置和動態設置，允許您在不重啟服務器的情況下在北美（na）、歐洲（eu）和遠東（fe）區域之間切換。

區域代碼	名稱	API端點
`na`	北美	https://advertising-api.amazon.com
`eu`	歐洲	https://advertising-api-eu.amazon.com
`fe`	遠東	https://advertising-api-fe.amazon.com

當您設置區域時，系統會自動執行以下操作：

更新API端點 - 將API調用路由到正確的區域端點。
更新OAuth端點 - 使用該區域正確的令牌刷新端點。
清除緩存的令牌 - 確保為新區域進行全新的身份驗證。
保留其他設置 - 保持資源ID和身份設置不變。

⚠️ 重要提示

避免區域不匹配：如果您嘗試設置與您的廣告商資源不關聯的區域，廣告API將拒絕您的請求。例如，如果一個資源ID與 na 區域相關聯，而您手動將區域設置為 eu，就會造成不匹配，從而導致API請求失敗。

獲取活動區域

如果您不確定當前設置的區域，可以檢查區域信息。

工具：get_active_region
返回：當前區域、端點和配置來源

示例提示："What is my current active region?"

💻 使用示例：連接Claude桌面

1. 導航到連接器設置

在瀏覽器中打開Claude，然後導航到設置頁面。您可以通過點擊您的個人資料圖標，然後從下拉菜單中選擇“設置”來訪問此頁面。進入設置後，在側邊欄中找到並點擊“連接器”部分。這將顯示您當前配置的連接器，並提供添加新連接器的選項。

2. 編輯Claude桌面配置文件

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

在這個示例中，我們展示瞭如何使用Openbridge API密鑰使用Bearer令牌。將以下配置添加到您的 mcpServers 部分：

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://${HOSTNAME}:${PORT}/mcp/",
        "--allow-http",
        "--header",
        "Authorization:Bearer ${OPENBRIDGE_REFRESH_TOKEN}",
        "--header",
        "Accept:application/json,text/event-stream",
        "--debug"
      ],
      "env": {
        "MCP_TIMEOUT": "300",
        "HOSTNAME": "your_hostname",
        "PORT": "your_server_port",
        "MCP_TIMEOUT": "120000",
        "MCP_REQUEST_TIMEOUT": "60000",
        "MCP_CONNECTION_TIMEOUT": "10000",
        "MCP_SERVER_REQUEST_TIMEOUT": "60000",
        "MCP_TOOL_TIMEOUT": "120000",
        "MCP_REQUEST_WARNING_THRESHOLD": "10000",
        "OPENBRIDGE_REFRESH_TOKEN": "your_openbridge_token_here"
      }
    }
  }
}

注意：將 hostname、port 和 your_openbridge_token_here 替換為您實際的OpenBridge令牌。

⚠️ 重要提示

Cursor和Claude桌面（Windows）存在一個問題，當調用npx時，參數中的空格不會被轉義，這會導致這些值被破壞。您可以使用 mcp-remote自定義頭文檔來解決這個問題。

配置可能如下所示：

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://${HOSTNAME}:${PORT}/mcp/",
        "--allow-http",
        "--header",
        "Authorization:${AUTH_HEADER}",
        "--header",
        "Accept: application/json, text/event-stream"
      ],
      "env": {
        "MCP_TIMEOUT": "300",
        "HOSTNAME": "your_hostname",
        "PORT": "your_server_port",
        "MCP_TIMEOUT": "120000",
        "MCP_REQUEST_TIMEOUT": "60000",
        "MCP_CONNECTION_TIMEOUT": "10000",
        "MCP_SERVER_REQUEST_TIMEOUT": "60000",
        "MCP_TOOL_TIMEOUT": "120000",
        "MCP_REQUEST_WARNING_THRESHOLD": "10000",
        "AUTH_HEADER": "Bearer <your_openbridge_token_here>"
      }
    }
  }
}

以下是另一個示例，如果您使用OAuth，則不需要 OPENBRIDGE_REFRESH_TOKEN：

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://localhost:9080/mcp/",
        "--allow-http"
      ],
      "env": {
        "MCP_TIMEOUT": "120000",
        "MCP_REQUEST_TIMEOUT": "60000",
        "MCP_CONNECTION_TIMEOUT": "10000",
        "MCP_SERVER_REQUEST_TIMEOUT": "60000",
        "MCP_TOOL_TIMEOUT": "120000",
        "MCP_REQUEST_WARNING_THRESHOLD": "10000"
      }
    }
  }
}

注意：有關與上述類似的各種Claude配置，請參閱 MCP Remote文檔以獲取最新設置/選項。

3. 重啟Claude桌面

保存配置文件後，重啟Claude桌面以加載新的MCP服務器。

⚠️ 上下文限制和活動MCP服務器工具

MCP工具的註冊和使用可能會影響您的人工智能系統使用限制。使用限制控制您在特定時間段內可以與人工智能系統（如Claude）進行交互的程度。正如Anthropic所說，可以將使用的信息量/數據量視為消耗“對話預算”。該預算決定了在需要等待限制重置之前，您可以向人工智能客戶端發送多少消息，或者可以工作多長時間。

MCP服務器工具會向模型的上下文提供元數據，如標題、描述、提示和模式。這些元數據會加載到大語言模型（LLM）的上下文窗口中，該窗口充當其短期工作內存。

每個客戶端（如Claude）都有一個固定大小的上下文窗口。這定義了它在單次交互中可以處理的最大信息量，包括用戶提示、系統指令、工具元數據和任何先前的消息。

您激活的工具越多，預先消耗的有限空間就越多。當您激活許多工具時，它們的組合模式和配置負載可能會顯著佔用這個上下文，您可能很快就會達到上下文上限。這時，您會開始看到關於超出聊天長度限制的錯誤或警告。

亞馬遜廣告MCP覆蓋了整個API。因此，可能會有數百個工具！