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 智能体在不到一分钟内即可开始工作。
🔗 开始 14 天免费试用 · 📘 文档 · ⚡ Actions · 📊 Amazon 数据架构 · 🎥 视频演示
🚀 快速开始
-
在 DataDoe 注册并连接你的 Amazon Seller Central 或 Vendor Central 账户。
-
在 DataDoe MCP Integrations 中创建 DataDoe MCP API 密钥。
-
将以下配置粘贴到你的 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>" } } } } -
向你的 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 卖家(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),并在提交前使用匹配的*_VERIFYAction 预览商品信息写入。 - 订单 - 取消订单商品、确认发货、购买配送、请求评价、向买家发送消息,或搜索当前订单(
AMAZON_ORDERS_FIND)和订单指标(AMAZON_ORDERS_GET_METRICS)。 - Vendor Central - 确认采购订单、提交发货,并获取标签、装箱单和交易状态。
- Amazon Ads - 在 Sponsored Products、Brands、Display、TV 和 Amazon DSP 中,添加、更新、删除和查找广告活动、广告组、目标、广告、广告关联以及 Sponsored Products 出价规则。
工作原理 - 智能体通过以下 MCP 工具运行每个 Action:
actions_details_schema_get- 获取该 Action 类型的负载架构。- 使用
dryRun=true的actions_start- 在不执行的情况下验证负载。 actions_start- 运行 Action 并获取 action id。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_upsert | COGS | 为 Seller Central 账户创建或更新销货成本行。 |
cogs_delete | COGS | 删除 Seller Central 账户的 COGS 行,支持可选筛选。 |
vendor_code_upsert | 供应商代码 | 为具有 Vendor Central 连接的账户创建或更新供应商代码行。 |
vendor_code_delete | 供应商代码 | 删除具有 Vendor Central 连接的账户的供应商代码行,支持可选筛选。 |
sqp_asins_get | SQP | 返回 Seller Central 账户的搜索查询表现(SQP)ASIN 列表。DataDoe 最多存储 252 个 ASIN。 |
sqp_asins_add | SQP | 每次调用最多向 Seller Central 账户的 SQP 列表添加 252 个 ASIN。 |
sqp_asins_remove | SQP | 每次调用最多从 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_find | AMC | 列出运行中的 Amazon Marketing Cloud(AMC)工作流及其调度和状态哈希。 |
amc_workflows_create | AMC | 创建 AMC 工作流(SQL,可选每日或每周调度),但不运行它。 |
amc_workflows_update | AMC | 更新 AMC 工作流的 SQL 和/或调度。 |
amc_workflows_delete | AMC | 删除 AMC 工作流及其调度。 |
amc_query_validate | AMC | 针对 Amazon 试运行工作流、原始 SQL 或查询模板,而不启动执行。 |
amc_query_start | AMC | 从工作流、原始 SQL 或查询模板启动按需 AMC 查询。 |
amc_query_cancel | AMC | 取消待处理或运行中的 AMC 查询。 |
amc_query_results_find | AMC | 列出 AMC 查询结果历史,并支持筛选。 |
amc_query_result_get | AMC | 返回单个 AMC 查询结果,在可用时包含短期下载 URL。 |
amc_schema_find | AMC | 读取实时 AMC schema:表索引,或某个数据源的字段。 |
amc_operation_get | AMC | 返回异步 AMC 操作的状态,例如工作流变更或不确定的查询启动。 |
amc_query_templates_find | AMC | 列出预制的 AMC 查询模板,并在选定账户时说明该账户能否运行每个模板。 |
amc_query_template_get | AMC | 返回单个 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 文档页面:
- 使用 Claude
- 使用 ChatGPT
- 使用 Claude Code
- 使用 Claude Agent SDK
- 使用 Codex
- 使用 Codex Sites
- 使用 CrewAI
- 使用 Cursor
- 使用 Excel + Claude
- 使用 Gemini CLI
- 使用 Gumloop
- 使用 Hermes Agent
- 使用 n8n
- 使用 NanoClaw
- 使用 OpenAI Agents SDK
- 使用 OpenClaw
- 使用 OpenCode
- 使用 PowerPoint + Claude
- 使用 VS Code
- 使用 Word + Claude
完整文档根目录: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 天免费试用。
文档与资源
- DataDoe 主页
- DataDoe 文档
- DataDoe Actions(写入 Amazon)
- Amazon 数据 schema 参考
- DataDoe MCP 产品页面
- DataDoe 与 Amazon MCP 对比
- DataDoe MCP 视频演示
- DataDoe 博客:Amazon SP-API、Ads API 和 MCP 讲解
- 创建 DataDoe MCP API 密钥
许可证
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