Google Merchant Center MCP

Google Merchant Center MCP

English | Русский

A1 Google Merchant Center MCP 将 AI 应用连接到你的 Google Merchant Center 账户。了解商品被拒登的原因，检查数据 Feed 和促销活动，查看报告和市场价格，并在需要时有针对性地修改商品数据。

它适用于 Shopping 商品列表背后的 Merchant Center 数据：商品、数据源、促销活动和报告。广告系列、预算和出价属于 Google Ads，不在此服务的范围内。

• 22 个工具。 15 个操作仅读取 Merchant Center 数据；5 个操作会写入商品、数据源或促销活动数据；2 个操作可能造成破坏性更改。
• 使用你的 Google 访问权限。 此服务使用你的 OAuth 凭据和 Merchant API v1，不会创建单独的 Merchant Center 账户。
• 根据数据源进行更改。 只能通过 API 数据源修改商品和促销活动输入。文件 Feed 可以重新获取，但无法在此处编辑其内容。
• 边界清晰可见。 工具带有只读、写入或破坏性操作的元数据，因此 AI 客户端可以区分检查操作和实际更改。

先从只读问题开始：

哪些商品被拒登了？Google 针对每件商品报告了哪些问题？

连接服务 · 探索使用场景 · 查看技术文档

一分钟了解其工作方式

你： 哪些商品被拒登了？Google 针对每件商品报告了哪些问题？

助手： 列出受影响的商品，并说明 Merchant Center 报告的商品级问题。

你： 显示商品 SKU-123 当前的价格和库存情况，然后准备将库存状态更新为 in_stock。

助手： 显示当前的商品输入、所属的 API 数据源以及要执行的具体更改。更新线上商品输入前，会先请求确认。

你： 确认更新。

助手： 提交更新，并说明 Merchant Center 会异步处理商品数据。处理后的商品及其质量状态可能需要几分钟才会刷新。

目录

• 快速开始
• 可以让它执行哪些操作
• Merchant Center 数据如何连接
• 可以更改哪些内容
• 获取访问权限
• 配置
• 数据和遥测
• 限制和后台工作
• 技术文档
• 支持

快速开始

你需要 Node.js 20+、Google Merchant Center 账号，以及一个已在 Merchant Center 中注册的 Google Cloud 项目。安装时不需要 OAuth 凭据 — 服务会在对话过程中连接，详见获取访问权限。

1. 使用以下任一说明，将服务添加到你的 AI 应用。
2. 说“连接 Google Merchant Center”：助手会引导你完成 OAuth 客户端设置和浏览器授权，无需配置文件，也无需重启。
3. 提出上方的第一个只读问题。

codex mcp add google-merchants \
  -- npx -y mcp-google-merchants@latest

codex mcp list

claude mcp add \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

claude mcp list

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"]
    }
  }
}

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"]
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "google_merchants_client_id",
      "description": "Google OAuth client ID"
    },
    {
      "type": "promptString",
      "id": "google_merchants_client_secret",
      "description": "Google OAuth client secret",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_refresh_token",
      "description": "Google OAuth refresh token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_account_id",
      "description": "Merchant Center account ID"
    }
  ]
}

可以让它做什么

查找并了解商品目录问题

• 哪些商品未获批准？Google 对每件商品给出了什么说明？
• 显示商品 SKU-123 的标题、价格、库存情况和当前状态。
• 哪些商品缺货？
• 显示此 Merchant Center 账号中最常见的商品问题。

探索表现和价格

• 显示 7 月按商品划分的点击量和展示次数。
• 在美国，哪些商品的定价高于市场基准？
• Google 建议的价格是多少？预计会产生什么影响？

价格比较和建议需要在 Merchant Center 中免费选择加入 Market Insights。如果账号尚未选择加入，服务会说明报告为何没有数据行。

检查账号和 Feed

• 列出我可以访问的 Merchant Center 账号。
• 商店首页是否已声明所有权？显示当前的配送设置。
• 列出商品和促销数据源，并指出其中一个 API 数据源。
• 立即重新获取此计划文件 Feed。

有意进行更改

• 更新此产品在其 API 数据源中的价格和供货情况。
• 为新的产品 Feed 创建 API 数据源。
• 创建或更新促销，然后检查其审批状态。

对于任何会更改数据的请求，请先让助手展示目标账号、数据源以及计划更改的确切字段。

Merchant Center 数据如何连接

Merchant Center 会将传入数据与由此生成的产品状态分开处理：

1. 一个 账号 包含产品和促销数据源。
2. 一个 数据源 可以是 API 来源、文件、Google Sheet、Merchant Center 界面或自动 Feed。
3. 一个 产品输入 是由单个来源提供的产品数据。
4. 一个 已处理产品 是 Merchant Center 处理该输入后生成的数据。其中包含符合资格的情况和商品级问题。

该服务可以读取所有列出的来源类型。它只能创建 API 数据源，并且只能更新 API 数据源中的产品输入；它无法写入文件、界面或自动 Feed。若要按条件查找产品，请使用报告查询：list_products 本身不支持服务器端筛选。

可以更改的内容

MCP 客户端会决定如何请求你确认写入和破坏性工具。服务会标记只读、写入和破坏性操作，以便客户端显示相应的确认边界。

获取访问权限

该服务使用 Google Merchant API 和 OAuth 范围 https://www.googleapis.com/auth/content。提供凭据有两种方式，第一种无需配置文件。

从聊天中连接（推荐）

说“连接 Google Merchant Center”，助手就会引导你完成流程：

1. setup_instructions 会打印检查清单：创建或选择 Google Cloud 项目、启用 Merchant API、配置同意屏幕并创建 桌面应用 OAuth 客户端。
2. 下载该客户端的 JSON（“Download JSON”），并将其路径提供给助手——set_client 会将其保存为仅所有者可访问。密钥不会通过对话传递。
3. start_login 会返回 Google 同意链接。在此设备上打开链接并批准；授权码会返回到 127.0.0.1 上的一次性监听器（PKCE），绝不会通过聊天传递。
4. finish_login 会交换授权码，将令牌保存到 ~/.config/mcp-google-merchants/credentials.json（模式为 0600），并通过实际的 Merchant API 调用验证令牌——因此，如果项目尚未注册到 Merchant Center，就会在此处发现问题。

每次调用都会重新读取令牌，因此连接会立即生效，无需重启 AI 应用。auth_status 会显示已连接的内容，logout 会撤销并删除连接。下方所述的 Cloud 项目注册仍然是必需步骤：这是 Merchant Center 步骤，而非 OAuth 步骤。

环境变量（CI、无人值守安装）

1. 创建或选择一个 Google Cloud 项目，启用 Merchant API，并配置 OAuth 同意屏幕。
2. 在 Google Cloud 中创建一个类型为 桌面应用 的 OAuth 客户端。保存其客户端 ID 和客户端密钥。
3. 授权有权访问你的 Merchant Center 的 Google 账号，并获取上述范围的刷新令牌。OAuth 2.0 Playground 可以帮助完成此步骤：启用 Use your own OAuth credentials，输入范围，进行授权，然后使用授权码换取令牌。
4. 在 Merchant Center 中找到你的 Merchant Center 账号 ID，并将其用作 GOOGLE_MERCHANTS_ACCOUNT_ID。
5. 在 Merchant Center 中注册 Google Cloud 项目一次。Google 要求使用经过验证的网站的生产 Merchant Center 账号，并由账号管理员执行此操作。注册会将一个 Cloud 项目关联到 Merchant Center 账号；在注册完成之前，该项目发出的 Merchant API 调用会被阻止。请按照 Google 的开发者注册指南操作。

可以通过技术性 raw_request 工具完成一次性注册，但如果这是你首次设置 Merchant API，建议按照 Google 的指南操作。注册后，Google 可能需要最多五分钟才会接受调用。

请将 OAuth 客户端密钥和刷新令牌视为密码。它们保存在 MCP 客户端配置中，并可授予对 Merchant Center 账号的访问权限。

配置

* 可以同时使用客户端 ID、客户端密钥和刷新令牌，也可以使用预先签发的访问令牌。访问令牌通常约一小时后过期；刷新令牌可让服务在需要时获取新的访问令牌。

数据与遥测

该服务在本地作为进程运行，由你的 AI 应用启动。它会向 Google 发送 Merchant Center 请求，并通过 Google 的 OAuth 端点刷新 OAuth 访问令牌。

它会发送匿名使用遥测数据，以统计活跃安装量和工具使用需求：随机安装 ID、软件包版本、AI 客户端和 Node.js/操作系统版本，以及工具名称。它绝不会发送或存储 OAuth 令牌、Merchant Center 数据、工具参数或提示词。为 A1 MCP 服务禁用此遥测：

ASKADS_TELEMETRY=0

限制与后台工作

• Merchant Center 处理是异步的。 新插入、更新或删除的商品输入信息，可能需要几分钟才会出现在已处理商品中。商品和促销活动的审核问题会稍后显示，不会立即作为 API 错误返回。
• Market Insights 是可选的。 只有账号加入免费的 Market Insights 计划后，价格竞争力和建议价格报告才会返回数据。
• 配额取决于账号和 API 方法。 使用 list_method_quotas 查看当前用量；Google 的每日计数器会在 12:00 UTC 重置。
• 谨慎处理临时限制。 Google 返回 429 时，服务会遵循提供的 Retry-After，并进行有限次数的重试。发生无法确认结果的网络或服务端故障后，不会重放写入操作。
• 没有后台监控。 只有 AI 应用调用时，服务才会运行。如果你的 AI 应用支持计划任务，可以让它定期检查商品问题或配额用量。
• 汇总商品问题存在账号限制。 list_product_issues 适用于独立账号和子账号，不适用于高级父账号。

技术文档

• MCP 能力目录 — 面向任务的页面，介绍每个工具。
• 所有工具及其输入
• 开发文档
• 发布文档
• Google Merchant API 概览
• Google Merchant API 身份验证
• Google 开发者注册

支持

发现错误或需要支持某个场景？创建 issue，或在 Telegram 上联系。

你已经读到了最后！