DataDoe

官方

為 Amazon Seller Central、Vendor Central 和 Amazon Ads 提供的託管 MCP 伺服器:AI 代理可讀取即時資料,並更新商品刊登、訂單和廣告活動

你可以用 DataDoe MCP 做什麼?

  • 查詢 Amazon 銷售資料 — 依 SKU 查詢各商城與時間區間內的訂單、銷售、流量、庫存、退貨或結算資料。
  • 建立自訂匯出 — 建立帶有類 SQL 篩選條件、GROUP BY、彙總與日期區間的匯出,並以 CSV 或 JSON 回傳。
  • 分析 Amazon Ads — 檢視廣告活動、關鍵字與搜尋詞成效,包括 ACoS、ROAS 與曝光比重指標。
  • 更新商品刊登與訂單 — 變更標題、要點、價格與圖片,或透過 Actions 取消訂單並確認出貨。
  • 管理 Ads 廣告活動 — 新增、更新、移除或暫停廣告活動、廣告群組、目標與廣告,並包含 dryRun 驗證步驟。
  • 執行 AMC 查詢 — 驗證、啟動 Amazon Marketing Cloud 查詢與工作流程,並擷取其結果。

文件

Amazon Seller MCP Server - DataDoe

託管的 Amazon Seller Central 與 Vendor Central MCP 伺服器,具備讀取與寫入權限。 將 Claude、ChatGPT、Cursor、Codex、Gemini 與 GitHub Copilot 連接到即時的 Amazon SP-API 與 Amazon Ads API 資料,然後讓你的 AI 代理據此採取行動:更新商品刊登、管理訂單,並最佳化 Amazon Ads 廣告活動。DataDoe 會處理 SP-API 開發者審核、OAuth 與速率限制,讓你的 AI 代理在不到一分鐘內就能開始運作。

Amazon Seller & Vendor SP-API Selling Partner API Amazon Ads API MCP Server Read and Write AI clients supported smithery badge License: MIT

🔗 開始 14 天免費試用 · 📘 文件 · ⚡ Actions · 📊 Amazon 資料結構描述 · 🎥 影片示範


🚀 快速開始

  1. 在 DataDoe 註冊,並連接你的 Amazon Seller Central 或 Vendor Central 帳戶。

  2. 在 DataDoe MCP Integrations 建立 DataDoe MCP API 金鑰。

  3. 將下列設定貼到你的 AI 用戶端(Claude、Cursor、Codex、Gemini、GitHub Copilot、ChatGPT,或任何支援 MCP 的工具):

    {
      "mcpServers": {
        "datadoe": {
          "url": "https://mcp.datadoe.com/mcp/v1",
          "headers": {
            "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
          }
        }
      }
    }
    
  4. 向你的 AI 代理詢問:「顯示我上個月在所有 Amazon 市集的營收前 10 大 ASIN。」

就是這樣。DataDoe 在託管基礎架構上執行 MCP 伺服器,因此你的團隊不需要在本機部署任何東西,也不必等待 Amazon SP-API 開發者審核。


什麼是 DataDoe MCP?

DataDoe MCP 是專為 Amazon 賣家、供應商與代理商 提供的託管 Model Context Protocol (MCP) 伺服器。它透過可與 Claude、ChatGPT、Cursor、Codex CLI、Gemini CLI、GitHub Copilot、Claude Desktop、n8n、NanoClaw 及任何其他支援 MCP 的用戶端搭配運作的 MCP 工具,公開你即時的 Amazon Selling Partner API (SP-API) 與 Amazon Ads API 資料。

DataDoe MCP 為你的 AI 代理在 Amazon 帳戶上提供兩層能力:

  • 讀取層 - SKU 層級的訂單、銷售、廣告支出、流量、庫存、商品刊登、退貨、結算、品牌分析與型錄,以結構化工具回應或可下載的 CSV 與 JSON 匯出形式回傳。
  • 寫入層(Actions) - 你的代理可透過 SP-API 與 Amazon Ads API 變更你的 Amazon 帳戶:更新商品刊登、取消訂單、確認出貨,以及管理 Amazon Ads 廣告活動、廣告群組、目標與廣告。

自行建置 Amazon SP-API 整合通常需要 SP-API 開發者註冊、OAuth 重新整理權杖流程、各市集專屬端點、節流邏輯,以及 2 至 4 週的 Amazon 審核。DataDoe 會處理所有這些事項。你會取得單一已驗證的 MCP URL,同時用於讀取與操作你的 Amazon 資料。

DataDoe MCP - Amazon Seller Central, Vendor Central, and Amazon Ads data for AI agents via SP-API

DataDoe MCP 適合誰使用?

  • Amazon 賣家(FBA、FBM、多市集) - 直接從你自己的賣家資料取得即時答案,不必切換到 Seller Central。
  • 管理多個客戶帳戶的 Amazon 代理商 - 從單一 MCP 伺服器查詢每個已連接的 Seller Central / Vendor Central 帳戶。
  • 使用 Vendor Central 的供應商 - 以相同工具同時讀取 1P 與 3P 資料。
  • AI 建置者與開發者 - 推出具備 Amazon 感知能力的 AI 代理、儀表板與內部工具,無須自行撰寫 SP-API 整合。
  • 營運團隊 - 透過 Claude Code、Cursor、n8n 或任何支援 MCP 的工作流程工具,自動化定期報表。

為什麼要使用 DataDoe MCP?

  • ✅ 無需 SP-API 審核 - DataDoe 代表你處理 SP-API 開發者註冊、OAuth、重新整理權杖與速率限制。
  • ✅ 30 秒完成設定 - 將 MCP URL 與你的 API 金鑰貼到 AI 用戶端設定中。DataDoe 在託管基礎架構上執行伺服器。
  • ✅ 內建 20 多項有文件說明的整合:Claude、ChatGPT、Cursor、Codex、Gemini CLI、GitHub Copilot、n8n、CrewAI、Claude 與 OpenAI Agent SDK、透過 Claude 使用 Excel / Word / PowerPoint,以及任何其他支援 MCP 的用戶端。
  • ✅ SKU 層級解析 - 深入個別 ASIN、父商品刊登、市集、時間區間、廣告活動、關鍵字報表、結算、退貨。
  • ✅ 多市集、多帳戶 - 單一 MCP 伺服器涵蓋 Seller Central 與 Vendor Central 中的每個 Amazon 市集(美國、英國、德國、法國、義大利、西班牙、加拿大、澳洲、日本、墨西哥等)。
  • ✅ AI 原生設計 - exports_create 接受類 SQL 的篩選群組、GROUP BY、彙總與日期區間,因此你的 AI 代理可透過單一工具呼叫建立複雜報表。
  • ✅ 單一方案、單一價格 - 每月 $97,含 14 天免費試用。請參閱定價。
  • ✅ 讀取與寫入 - 透過 Actions,你的代理不只是產生報表,還能更新商品刊登、管理訂單並最佳化 Amazon Ads,並具備 dryRun 驗證步驟與各類型控制項。
  • ✅ 全年無休的託管基礎架構 - DataDoe 管理 SP-API 速率限制、權杖輪替與持續維護。

你可以向 DataDoe MCP 詢問什麼?

連接 DataDoe MCP 後,你的 AI 代理可回答的範例問題:

  • 「上個月在所有 Amazon 市集中,我的營收前 20 大 ASIN 是哪些?」
  • 「將我第一季的 Amazon 結算與訂單對帳,並顯示任何差異。」
  • 「上週哪些 Amazon Ads 廣告活動的 ACoS 超過 40%,其總支出是多少?」
  • 「顯示未來 14 天內有缺貨風險的庫存單位。」
  • 「為我建立過去 90 天包含銷售、流量與廣告支出的每日 KPI 儀表板。」
  • 「我的 PPC 報表中哪些搜尋詞帶來最多點擊但零轉換?」
  • 「取出 SKU ABC-123 在過去 60 天的每一筆 Amazon 退貨,並摘要退貨原因。」
  • 「逐月比較我的品牌分析搜尋詞聲量佔有率。」

而啟用 Actions 後,你的代理可以對其發現採取行動:

  • 「將我 ACoS 最低的 Sponsored Products 廣告活動每日預算提高 20%。」
  • 「暫停上週 ACoS 超過 50% 的每個廣告活動。」
  • 「將 SKU ABC-123 的價格更新為 19.99,並更新其要點。」
  • 「以 UPS 追蹤編號 1Z999... 確認訂單 123-4567890-1234567 的出貨。」

Actions:寫入 Amazon

Actions 讓你的 AI 代理透過 SP-API 與 Amazon Ads API,在你已連接的 Amazon Seller Central、Vendor Central 與 Amazon Ads 帳戶上進行變更。每個 Action 都會被記錄且可稽核。

你的代理可以做的事:

  • 商品刊登 - 更新標題、要點、描述、通用關鍵字、品類關鍵字與圖片(AMAZON_LISTINGS_UPDATE)、更新 Seller Central 帳戶的價格(AMAZON_LISTINGS_PRICING_UPDATE),並在提交前使用對應的 *_VERIFY Action 預覽商品刊登寫入。
  • 訂單 - 取消訂單項目、確認出貨、購買運送服務、請求評論、傳訊息給買家,或搜尋目前訂單(AMAZON_ORDERS_FIND)與訂單指標(AMAZON_ORDERS_GET_METRICS)。
  • Vendor Central - 確認採購訂單、提交出貨,並取得標籤、裝箱單與交易狀態。
  • Amazon Ads - 在 Sponsored Products、Brands、Display、TV 與 Amazon DSP 中新增、更新、移除及尋找廣告活動、廣告群組、目標、廣告、廣告關聯與 Sponsored Products 出價規則。

運作方式 - 代理透過下列 MCP 工具執行每個 Action:

  1. actions_details_schema_get - 取得該 Action 類型的承載結構描述。
  2. 使用 dryRun=true 執行 actions_start - 驗證承載而不實際執行。
  3. actions_start - 執行 Action 並取得 action id。
  4. actions_get - 輪詢直到完成,然後讀取 result。

使用 actions_list 檢閱過去的 Actions(依狀態、類型、建立者與日期篩選)。

Action 類型預設為停用,並在 Settings > Actions 中依類型啟用。當某類型停用時,actions_start 會拒絕實際執行,但仍允許 dryRun 驗證。

以下是 AMAZON_LISTINGS_UPDATE 的 details 承載範例:

{
  "type": "AMAZON_LISTINGS_UPDATE",
  "sellerOrVendorId": "<SELLER_OR_VENDOR_UUID>",
  "dryRun": true,
  "details": {
    "changes": [
      {
        "sku": "ABC-123",
        "language_tag": "en_US",
        "name": "Stainless Steel Water Bottle 750ml",
        "bulletPoints": ["Keeps drinks cold for 24 hours", "Leak-proof lid"]
      }
    ]
  }
}

執行一個 Action 最多 100 項變更需花費 3 個 AI Token,之後每增加 100 項變更再加 1 個 AI Token。完整目錄與承載結構描述請參閱 Actions 文件。

可用的 MCP 工具

DataDoe MCP 向你的 AI 用戶端公開下列工具:

工具類別功能說明
sellers_and_vendors_list帳戶列出連接到您 DataDoe 組織的 Amazon 賣家和供應商,包含帳戶類型、商城和連接詳細資訊。
sellers_and_vendors_get帳戶傳回單一賣家或供應商,包含該連接是否需要重新授權。
sellers_and_vendors_rename帳戶重新命名賣家或供應商。名稱在組織內必須唯一。
sellers_and_vendors_invitation_create帳戶建立一次性連結,用於連接新的 Amazon 帳戶或重新連接現有帳戶。
sellers_and_vendors_invitations_get帳戶列出待處理的邀請,或傳回單一邀請及其狀態。
sellers_and_vendors_invitation_revoke帳戶撤銷待處理的邀請,使其連結無法再使用。
organization_and_subscription_details_get帳戶傳回您的 DataDoe 組織設定檔、訂閱方案、帳務健康狀態和 AI Token 餘額。
exports_sources_get資料依關鍵字搜尋 DataDoe 的 Amazon 資料匯出來源目錄(訂單、銷售與流量、廣告成效、庫存、商品刊登、結算、退貨、品牌分析等)。
exports_source_get資料傳回單一匯出來源的欄位(分頁)和中繼資料,包含是否需要日期區間。
exports_create資料從任何來源建立 Amazon 資料匯出。支援類 SQL 篩選、HAVING、GROUP BY、彙總(sum / avg / count / countDistinct / min / max)、日期區間(DAY / WEEK / MONTH)、分頁,以及 CSV 或 JSON 輸出。
exports_get資料傳回進行中或已完成匯出工作的狀態和中繼資料。
exports_list資料列出組織的匯出工作,支援分頁和選用的匯出 ID 篩選。
exports_raw_url_get資料傳回已完成匯出的下載 URL,有效期至匯出建立後 15 分鐘。
exports_raw_download資料在工具回應中直接傳回原始匯出內容(CSV 或 JSON)。
exports_delete資料依 ID 刪除匯出。
files_create檔案以 base64 編碼內容建立並上傳公用檔案(商品刊登圖片、A+ 圖片或訂單訊息檔案)。
files_list檔案列出組織的公用檔案,支援分頁和篩選。
files_get檔案依 id 傳回公用檔案的中繼資料。
files_download_url_get檔案傳回已上傳檔案的下載 URL,有效期至檔案建立後 15 分鐘。
files_delete檔案刪除公用檔案及其儲存物件(若存在)。
datadoe_user_docs_table_of_contents_get文件傳回 DataDoe 使用者文件的目錄,適合代理程式需要隨需查閱功能或能力時使用。
datadoe_user_docs_page_get文件傳回指定 DataDoe 文件頁面的完整內容。
actions_details_schema_get動作傳回 details 承載內容的 JSON Schema、存取模式(READ 或 WRITE)、該動作類型是否已啟用,以及啟動工具。
actions_start動作在您的 Amazon 帳戶上啟動 READ 或 WRITE 動作(商品刊登、訂單、A+ 內容、多管道配送、Amazon Ads)。將 dryRun=true 設為驗證而不執行。傳回動作 id。
actions_get動作依 id 傳回動作的狀態和 result;請在 actions_start 之後輪詢。
actions_list動作傳回分頁的動作歷史記錄,可依狀態、類型、建立者和日期篩選。
cogs_upsertCOGS為 Seller Central 帳戶建立或更新銷貨成本資料列。
cogs_deleteCOGS為 Seller Central 帳戶刪除 COGS 資料列,支援選用篩選。
vendor_code_upsert供應商代碼為具有 Vendor Central 連接的帳戶建立或更新供應商代碼資料列。
vendor_code_delete供應商代碼為具有 Vendor Central 連接的帳戶刪除供應商代碼資料列,支援選用篩選。
sqp_asins_getSQP傳回 Seller Central 帳戶的搜尋查詢成效(SQP)ASIN 清單。DataDoe 最多儲存 252 個 ASIN。
sqp_asins_addSQP每次呼叫最多新增 252 個 ASIN 至 Seller Central 帳戶的 SQP 清單。
sqp_asins_removeSQP每次呼叫最多從 Seller Central 帳戶的 SQP 清單移除 252 個 ASIN。
plugins_get外掛傳回組織中儲存的記憶和技能,以及可供使用者使用的檔案。
plugins_memories_create外掛為使用者或組織建立記憶外掛。
plugins_memories_edit外掛為使用者或組織更新記憶外掛。
plugins_memories_delete外掛為使用者或組織刪除記憶外掛。
plugins_skills_get外掛傳回由 plugins_get 列出的技能元素(SKILL.md 或支援檔案)。
plugins_files_get外掛傳回由 plugins_get 列出的檔案外掛所轉換的 markdown 內容。
amc_workflows_findAMC列出執行中的 Amazon Marketing Cloud(AMC)工作流程及其排程和狀態雜湊。
amc_workflows_createAMC建立 AMC 工作流程(SQL,可選用每日或每週排程)而不執行。
amc_workflows_updateAMC更新 AMC 工作流程的 SQL 和/或排程。
amc_workflows_deleteAMC刪除 AMC 工作流程及其排程。
amc_query_validateAMC對 Amazon 試跑工作流程、原始 SQL 或查詢範本,而不啟動執行。
amc_query_startAMC從工作流程、原始 SQL 或查詢範本啟動隨需 AMC 查詢。
amc_query_cancelAMC取消待處理或執行中的 AMC 查詢。
amc_query_results_findAMC列出 AMC 查詢結果歷史記錄,支援篩選。
amc_query_result_getAMC傳回單一 AMC 查詢結果,包含可用時的有效期短暫下載 URL。
amc_schema_findAMC讀取即時 AMC 結構描述:資料表索引,或單一資料來源的欄位。
amc_operation_getAMC傳回非同步 AMC 操作的狀態,例如工作流程變更或狀態不確定的查詢啟動。
amc_query_templates_findAMC列出預製的 AMC 查詢範本,並在選取帳戶時顯示該帳戶是否能執行每個範本。
amc_query_template_getAMC傳回單一 AMC 查詢範本,包含其 SQL。
datadoe_support_ticket_create支援向 DataDoe 團隊傳送支援請求。
datadoe_support_ticket_check支援讀取支援請求及任何回覆。約每小時輪詢一次。
datadoe_support_ticket_update支援為現有支援請求新增更多資訊。

Amazon Marketing Cloud(AMC)工具僅限申請使用,且只有在授予存取權後才會由即時伺服器列出。請參閱 Amazon Marketing Cloud。


各 AI 用戶端快速設定

以下程式碼片段是您所需的最低設定。如需各 AI 用戶端的逐步指南,請參閱本節末尾的各用戶端設定指南清單。

Claude.ai · Claude Desktop

將 DataDoe 新增為自訂連接器:開啟 Customize > Connectors,按一下 Add,並將 https://mcp.datadoe.com/mcp/v1 貼上作為 MCP Server URL。Claude 會使用 OAuth 登入 DataDoe,因此您不需要 API 金鑰。請參閱使用 Claude。

Claude Code

claude mcp add datadoe "https://mcp.datadoe.com/mcp/v1" --transport http --header "datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY>"

伺服器名稱和 URL 必須放在 --header 之前。您也可以省略 --header,並在 Claude Code 中執行 /mcp 並選擇 Authenticate,以 OAuth 登入。

Cursor

新增至 ~/.cursor/mcp.json(全域)或 .cursor/mcp.json(各專案):

{
  "mcpServers": {
    "datadoe": {
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

GitHub Copilot(VS Code)

新增至 .vscode/mcp.json(各專案)或您的使用者 MCP 設定(MCP: Open User Configuration):

{
  "servers": {
    "datadoe": {
      "type": "http",
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

Codex CLI · Gemini CLI · ChatGPT · n8n · NanoClaw · 任何其他 MCP 用戶端

DataDoe MCP 可作為通用遠端 MCP 伺服器運作。請使用以下設定配置您的用戶端:

  • URL:https://mcp.datadoe.com/mcp/v1
  • 傳輸:HTTP Streamable
  • 驗證標頭:datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY>(在 DataDoe MCP Integrations 中建立金鑰)

各用戶端設定指南

如需各 AI 用戶端的逐步設定指南,請參閱專屬的 DataDoe 文件頁面:

完整文件根目錄:www.datadoe.com/hub/docs


有哪些 Amazon 資料可用?

DataDoe MCP 公開 DataDoe 中所有可用的 Amazon 資料表,涵蓋 Seller Central、Vendor Central 和 Amazon Ads 的 130 多個資料表,包括:

  • 訂單與銷售:訂單明細項目、訂單成效、銷售與流量、退款
  • Amazon Ads:廣告活動、廣告群組、關鍵字、搜尋詞、贊助商品 / 品牌 / 展示廣告、ACoS / ROAS / 曝光佔有率指標
  • 庫存:FBA 庫存、補貨建議、滯留庫存、庫齡、有風險的單位
  • 商品刊登與目錄:ASIN 目錄、產品屬性、購買盒擁有權、變體
  • 財務:結算、費用、準備金、補償、存款
  • 退貨:客戶退貨、退貨原因、FBA 退貨
  • 品牌分析:搜尋查詢成效、市場購物籃、重複購買、人口統計
  • 流量:工作階段、頁面瀏覽次數、轉換率,依 ASIN、依商城

完整結構描述:www.datadoe.com/hub/data-scheme


DataDoe MCP 不是什麼

為避免在評估 Amazon MCP 伺服器時產生混淆:

  • ❌ 不是自架式 MCP 伺服器。 DataDoe MCP 託管於 mcp.datadoe.com。此 GitHub 儲存庫是用於將 DataDoe MCP 發佈至公開 MCP 登錄(Official MCP Registry、mcpservers.org、glama.ai、mcpmarket.com、Cline、smithery.ai 等)的結構描述 facade。
  • ❌ 不是由您自行操作的 SP-API 包裝器。 DataDoe 負責 SP-API 開發者註冊、OAuth 流程、refresh token 輪替、商城端點和速率限制處理。您只需提供 Amazon 帳戶,其餘由我們處理。
  • ❌ 不是免費的開源伺服器。 DataDoe MCP 是 DataDoe 訂閱的一部分:每月 $97,提供 14 天免費試用。

文件與資源


授權

MIT。此儲存庫中的 DataDoe MCP 結構描述 facade 為開源。託管的 MCP 伺服器、DataDoe 應用程式和 DataDoe 基礎設施為專有,由 DataDoe, Inc. 提供。


如何在本機啟動並連接(用於索引和刊登)

此伺服器只是實際 DataDoe MCP 伺服器的結構描述 facade,用於將 DataDoe MCP 公開至各種 MCP 登錄。 它是一個 no-op 伺服器:除了公開 DataDoe MCP 的結構描述外,不做任何事。 如果您想實際使用 DataDoe MCP,請參閱 DataDoe MCP 文件。

1. 安裝相依套件

yarn install

2. 建置本機伺服器

yarn build

這會將 TypeScript 原始碼編譯至 dist/index.js。

3. 啟動伺服器

yarn start

伺服器透過 stdio 進行通訊,因此此程序應由你的 MCP 用戶端啟動,而非在瀏覽器中開啟。

4. 從 MCP 用戶端連線

若為本機設定,請將你的用戶端指向建置後的進入點。典型的 mcp.json 如下所示:

{
  "mcpServers": {
    "datadoe": {
      "command": "node",
      "args": ["/absolute/path/to/datadoe-mcp/dist/index.js"]
    }
  }
}

如果你的用戶端支援以環境變數設定工作區路徑,你通常可以將絕對路徑替換為你機器上實際的複製位置。


DataDoe 是 DataDoe, Inc. 的產品 · datadoe.com