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) 服务器。它通过 MCP 工具公开你实时的 Amazon Selling Partner API (SP-API) 和 Amazon Ads API 数据,这些工具可与 Claude、ChatGPT、Cursor、Codex CLI、Gemini CLI、GitHub Copilot、Claude Desktop、n8n、NanoClaw 以及任何其他支持 MCP 的客户端配合使用。

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 构建者和开发者 - 无需编写自己的 SP-API 集成,即可交付具备 Amazon 感知能力的 AI 智能体、仪表板和内部工具。
  • 运营团队 - 通过 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 报告中哪些搜索词带来了最多点击但零转化?”
  • “提取过去 60 天内 SKU ABC-123 的每一笔 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 类型默认禁用,并在设置 > 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 Tokens,每额外 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每次调用最多向 Seller Central 账户的 SQP 列表添加 252 个 ASIN。
sqp_asins_removeSQP每次调用最多从 Seller Central 账户的 SQP 列表中移除 252 个 ASIN。
plugins_get插件返回组织中保存的 Memories 和 Skills,以及为用户准备好的 Files。
plugins_memories_create插件为用户或组织创建记忆插件。
plugins_memories_edit插件更新用户或组织的记忆插件。
plugins_memories_delete插件删除用户或组织的记忆插件。
plugins_skills_get插件返回由 plugins_get 列出的 Skill 元素(SKILL.md 或支持文件)。
plugins_files_get插件返回由 plugins_get 列出的 File 插件的转换后 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 schema:表索引,或某个数据源的字段。
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:广告活动、广告组、关键词、搜索词、Sponsored Products / Brands / Display、ACoS / ROAS / 曝光份额指标
  • 库存:FBA 库存、补货建议、滞留库存、库龄、风险单位
  • 商品列表与目录:ASIN 目录、商品属性、Buy Box 归属、变体
  • 财务:结算、费用、准备金、赔偿、存款
  • 退货:客户退货、退货原因、FBA 退货
  • 品牌分析:搜索查询表现、市场篮子、重复购买、人口统计
  • 流量:会话数、页面浏览量、转化率,按 ASIN、按商城

完整 schema: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 等)的 schema 门面。
  • ❌ 不是由你自己运营的 SP-API 封装。 DataDoe 负责 SP-API 开发者注册、OAuth 流程、刷新令牌轮换、商城端点和速率限制处理。你只需提供 Amazon 账户,其余由我们处理。
  • ❌ 不是免费的开源服务器。 DataDoe MCP 是 DataDoe 订阅的一部分:每月 $97,含 14 天免费试用。

文档与资源


许可证

MIT。此仓库中的 DataDoe MCP schema 门面是开源的。托管的 MCP 服务器、DataDoe 应用程序和 DataDoe 基础设施为专有内容,由 DataDoe, Inc. 提供。


如何在本地启动和连接(用于索引和上架)

此服务器只是实际 DataDoe MCP 服务器的 schema 门面,用于将 DataDoe MCP 暴露给各种 MCP 注册表。 它是一个空操作服务器:除了暴露 DataDoe MCP 的 schema 之外,不做任何事情。 如果你想实际使用 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