商家数据 MCP 服务器（公开 Alpha 版）

直接从您选择的编码助理获取有关 Merchant Center 账号的实时数据。在集成开发环境 (IDE) 或自定义代理框架中，您现在可以使用 Model Context Protocol (MCP) 服务访问和管理 Merchant Center 数据。 借助此服务，您的编码助理或代理可以对 Merchant Center 数据执行只读和安全写入操作，从而诊断问题、检查计划并查询报告，同时提供权威的实时上下文。

如需详细了解该协议本身，请参阅 Model Context Protocol 标准。

安全性和访问权限控制

Merchant Data MCP 服务器的设计以安全性为首要考虑因素：

  • 身份验证：工具执行严格遵循标准 Merchant API 身份验证， 需要 OAuth 2.0 或服务账号凭据。
  • 执行安全性：尽管您的代理可以广泛查看工具架构，但任何工具的实际执行仍然高度安全，并且受到您的特定 API 凭据的严格限制。

重要注意事项

在使用这些工具之前，请查看以下最佳实践和限制：

更改和发布

我们会发布有关版本说明更改的信息，但这些更改可能会立即生效，而不会有弃用期。

安全测试

我们建议您先使用 测试账号或非正式 账号进行实验，然后再在正式生产环境中使用这些工具。

共享配额

MCP 服务器与您的标准 Merchant API 调用共享相同的配额池。运行代理可能会快速耗尽配额，尤其是在提取数据源时。我们强烈建议您使用测试账号，以防止生产服务中断。

工具过滤和安全性

Google 将来可能会向此 MCP 服务器添加新工具（包括写入功能）。为防止 AI 智能体自动 且无意地执行新的或有风险的工具，我们强烈建议您 将客户端明确配置为 内置工具 过滤 ，而不是公开整个工具集。

范围和限制

  • 专注于只读：作为此初始阶段的安全防护措施，这些 工具严格限于只读操作和低风险写入 工具（例如数据源创建）。

可用的功能

您可以使用 Merchant Data MCP 服务器以代理方式执行以下操作：

  • 使用确切的资源名称检索指定商品的详细状态和报告 上下文。
  • 列出和搜索 多个商品。
  • 通过搜索报告查询 效果数据、商品状态和价格分析。
  • 列出、创建、提取和检查 数据源的上传状态。
  • 识别 影响商品曝光度或计划参与度的账号级问题。
  • 列出 整个商品目录中商品被拒登的汇总原因。
  • 检查 特定 Merchant Center 计划的有效区域、未满足的要求和参与状态。
  • 查看 商品、图片和配送的自动优化设置。

设置

如需将 IDE 或编码助理连接到 Merchant Data MCP 服务器，请更新 MCP 客户端设置。例如，更新 Claude Desktop、Antigravity、Visual Studio Code 或自定义代理框架的 mcp.json 文件。

本地 MCP 服务器设置需要服务账号 。此无头本地执行 不支持 标准用户 OAuth 。您必须创建服务账号，下载其 JSON 私钥文件，并提供该文件的路径以及您的特定 Merchant Center ID 作为参数。

如需详细了解如何创建和下载服务账号， 请参阅服务账号指南。

客户端配置

配置设置：

Antigravity

按照 Antigravity 文档中的说明操作。

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

按照 Claude Desktop 文档中的说明操作。

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

使用场景示例

借助 Merchant Data MCP 服务器，您的代理可以与您的实时 Merchant Center 数据进行交互。以下介绍了一些常见的情况：

场景 1：诊断商品拒登问题

您想了解特定商品为何未显示在 Google 搜索结果中。

用户提示：

“为何我的商品（优惠 ID 为 'offer123'）被拒登？”

使用 MCP 的代理行为：

  1. 代理调用 list_products 或 get_product_by_name 以查找商品状态。
  2. MCP 服务器返回商品状态，包括 issues 列表（例如“价格格式不正确”或“缺少配送值”）。
  3. 代理分析问题并向您说明根本原因，同时建议如何解决问题（例如更新价格信息）。

场景 2：检查自动优化功能

您想验证自动配送优化功能是否已启用。

用户提示：

“我的自动配送优化功能是否已启用？”

使用 MCP 的代理行为：

  1. 代理调用 get_automatic_improvements 以检索账号级设置。
  2. MCP 服务器返回配置，其中显示了图片、商品和配送优化功能的状态。
  3. 代理确认配送优化功能已启用，或者说明如何启用（如果该功能处于关闭状态）。

场景 3：查询效果指标

您想快速查看近期效果，而无需浏览 Merchant Center 界面。

用户提示：

“显示上周点击次数最多的 5 个商品。”

使用 MCP 的代理行为：

  1. 代理构建一个 Merchant Center 查询语言 (MCQL) 查询 以 product_performance_view 表为目标，按 clicks DESC 排序，并限制为 5。
  2. 代理使用构建的查询调用 report_search。
  3. MCP 服务器针对实时报告数据库执行查询并返回行。
  4. 代理将结果格式化为简洁的 Markdown 表格供您使用。

可用工具的详细列表

MCP 服务器向您的代理公开以下工具：

MCP 工具 说明
get_product_by_name 使用确切的商品资源名称获取给定商家的商品信息。返回详细的商品状态，其中包含报告上下文和潜在的商品级问题。
list_products 列出或搜索给定商家的多个商品。返回详细的商品状态，其中包含报告上下文和潜在的商品级问题。
report_search 查询报告表格以检索效果指标、商品状态和价格分析。如需了解详情，请参阅报告指南。
list_data_sources 列出给定商家的数据源。
get_data_source 获取特定数据源的详细信息。
create_data_source 为给定商家创建数据源。
fetch_data_source 提取并处理与给定商家的数据源关联的文件。
get_file_upload 获取给定数据源的最新文件上传状态。
list_accounts 列出给定用户的账号。
list_account_issues 列出给定商家的账号级问题，以识别账号级问题。
list_programs 列出给定商家的计划，包括参与状态、有效区域和任何未满足的要求。
list_aggregated_product_issues 列出汇总的商品级问题，以监控商品数据的整体健康状况。
get_automatic_improvements 获取自动优化设置，包括商品更新、图片优化和配送优化。