商家資料 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 使用者介面。

使用者提示：

「Show me my top 5 performing products by clicks last week.」(顯示上週點擊次數前 5 名的產品。)

使用 MCP 時的代理程式行為：

  1. 代理程式會建構以 product_performance_view 資料表為目標的 Merchant Center 查詢語言 (MCQL) 查詢，並依 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 取得自動改善設定，包括商品更新、圖片改善和運送服務改善。