Google Merchant Center MCP

Google Merchant Center MCP

英語 | ロシア語

A1 Google Merchant Center MCP は、AI アプリをお使いの Google Merchant Center アカウントに接続します。商品が不承認となった理由の確認、フィードやプロモーションの調査、レポートや市場価格の確認を行い、必要に応じて商品データを慎重に変更できます。

このサーバーは、ショッピング リスティングの基盤となる Merchant Center データ（商品、データソース、プロモーション、レポート）を扱います。キャンペーン、予算、入札単価は Google Ads の機能であり、このサーバーの対象外です。

• 22 個のツール。 15 個の操作は Merchant Center データの読み取りのみを行い、5 個は商品、データソース、またはプロモーションのデータを書き込み、2 個は破壊的な操作となる可能性があります。
• お使いの Google アクセスを使用。 サーバーはお使いの OAuth 認証情報と Merchant API v1 を使用し、別の Merchant Center アカウントを作成することはありません。
• データソースに応じた変更。 商品とプロモーションの入力データは、API データソース経由でのみ変更できます。ファイルフィードは再取得できますが、その内容をここで編集することはできません。
• 明確な境界。 ツールには読み取り専用、書き込み、または破壊的な操作のメタデータが付与されるため、AI クライアントは調査と実際の変更を区別できます。

まずは読み取り専用の質問から始めましょう。

不承認となっている商品と、それぞれについて Google が報告している問題を教えてください。

サーバーを接続する · ユースケースを見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： 不承認となっている商品と、それぞれについて 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 にオプトインする必要があります。アカウントがオプトインしていない場合、レポートに行がない理由をサーバーが説明します。

アカウントとフィードを確認する

• アクセスできる Merchant Center アカウントを一覧表示してください。
• ストアのホームページは申請済みですか？現在の配送設定を表示してください。
• 商品とプロモーションのデータソースを一覧表示し、API データソースを特定してください。
• このスケジュール済みファイルフィードを今すぐ再取得してください。

変更を慎重に行う

• この商品の価格と在庫状況を API データソースで更新します。
• 新しい商品フィード用の API データソースを作成します。
• プロモーションを作成または更新し、承認状況を確認します。

データを変更するリクエストでは、まず変更予定の対象アカウント、データソース、正確なフィールドをアシスタントに表示させてください。

Merchant Center データの接続方法

Merchant Center では、受信データと処理後の商品ステータスが別々に管理されます。

1. アカウントには、商品とプロモーションのデータソースが含まれます。
2. データソースは、API ソース、ファイル、Google スプレッドシート、Merchant Center のインターフェース、自動フィードのいずれかです。
3. 商品入力は、1 つのソースから提供される商品データです。
4. 処理済み商品は、その入力を処理した結果として Merchant Center が生成するデータです。適格性と商品単位の問題が含まれます。

サーバーは、一覧にあるすべての種類のソースを読み取れます。API データソースの作成と商品入力の更新は API データソースに対してのみ行えます。ファイル、インターフェース、自動フィードには書き込めません。条件で商品を検索するには、レポートクエリを使用してください。list_products 自体はサーバー側のフィルタリングに対応していません。

変更できる内容

書き込みツールや破壊的なツールについて、どのように確認を求めるかは MCP クライアントが決定します。サーバーは読み取り専用、書き込み、破壊的な操作を区別して示し、クライアントが適切な確認を提示できるようにします。

アクセスの取得

このサーバーは Google Merchant API と OAuth スコープ https://www.googleapis.com/auth/content を使用します。認証情報を渡す方法は 2 つあり、1 つ目は設定ファイルが不要です。

チャットから接続する（推奨）

「Google Merchant Center に接続して」と伝えると、アシスタントが手順を案内します。

1. setup_instructions がチェックリストを表示します。Google Cloud プロジェクトの作成または選択、Merchant API の有効化、同意画面の設定、デスクトップアプリの OAuth クライアントの作成を行います。
2. そのクライアントの JSON（「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 プロジェクト登録は引き続き必要です。これは OAuth ではなく Merchant Center の手順です。

環境変数（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. Google Cloud プロジェクトを Merchant Center に一度登録します。この操作には、ウェブサイトが確認済みで、アカウント管理者がいる本番環境の Merchant Center アカウントが必要です。登録によって、1 つの Cloud プロジェクトが Merchant Center アカウントに紐付けられます。登録が完了するまでは、そのプロジェクトからの Merchant API 呼び出しはブロックされます。Google のデベロッパー登録ガイドに従ってください。

この一度限りの登録は、技術者向けのraw_requestツールから実行できますが、Merchant API を初めて設定する場合は、Google のガイドに従う方が安全です。登録後、Google が呼び出しを受け付けるまで最大 5 分かかることがあります。

OAuth クライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。これらは MCP クライアントの設定に保存され、Merchant Center アカウントへのアクセスを許可する可能性があります。

設定

* クライアント ID、クライアントシークレット、リフレッシュトークンをすべて使用するか、事前に発行されたアクセストークンを使用してください。アクセストークンは通常、約 1 時間で期限切れになります。リフレッシュトークンを使用すると、必要に応じてサーバーが新しいアクセストークンを取得できます。

データとテレメトリ

このサーバーは、AI アプリによって起動されるプロセスとしてローカルで実行されます。Merchant Center へのリクエストを Google に送信し、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 に書き込んでください。

最後まで読んでいただき、ありがとうございます！