Merchant API MCP Access Service（アルファ版）

Merchant API Model Context Protocol（MCP）アクセス サービスを使用すると、Merchant Center のデータと分析情報に承認されたアクセス権を取得して、新しいエージェント エクスペリエンスと自動ワークフローを構築できます。

概要

Merchant API MCP アクセス サービスは、LLM、エージェント、コーディング アシスタントが Merchant Center のデータに基づいて新しいエージェント エクスペリエンスと自動ワークフローを構築して調整するための、標準化された安全なブリッジを提供します。

具体的には、Merchant Center のデータと Google が生成したレポートや分析情報への承認されたアクセスを許可し、読み取り専用のオペレーションと制限付きの書き込みオペレーションを実行して、次のようなユースケースに対応できます。

• 商品の不承認を診断して修正する
• パフォーマンス レポートと分析情報を生成する
• 自動改善のオプトインを確認する
• データソースを作成して取得する

安全性とアクセス制御

Merchant API MCP アクセス サービスは、セキュリティを重視して設計されています。

• 認証: ツールの実行は標準の Merchant API 認証に則って管理され、 OAuth 2.0 またはサービス アカウントの認証情報が必要です。可能な限り制限の厳しいアクセス権を持つ認証情報を使用することをおすすめします。
• 実行の安全性: エージェントによる 検出ではツールの可視性が制限されませんが、ツールの実行は特定の API 認証情報に制限されます。
• 安全保護対策: 安全保護対策として、ツールは読み取り専用オペレーションと リスクの低い書き込みツール（データソースの作成など）に厳しく制限されます。

重要な考慮事項

Merchant API MCP アクセス サービスはアルファ版です。範囲と機能は拡張され、変更される可能性があります。

始める前に、次の制限事項とベスト プラクティスを確認してください。

変更とリリース

変更は事前通知なく行われる可能性があり、リリースノートに公開されます。

安全なテスト

本番環境でこれらのツールを使用する前に、 テスト アカウントまたはライブではない アカウントを使用して最初に試すことをおすすめします。

共有割り当て

Merchant API MCP アクセス サービスは、標準の Merchant API 呼び出しと同じ割り当てプールを共有します。エージェントを実行すると、特にデータソースの取得で割り当てがすぐに使い果たされる可能性があります。本番環境でのサービスの中断を防ぐため、テスト アカウントを使用することを強くおすすめします。

ツールのフィルタリングと安全性

今後、新機能、特に書き込みアクションが追加される予定です。 ツールセット全体を公開するのではなく、組み込みのツールフィルタリングを使用するようにクライアントを明示的に構成することを強くおすすめします。

使用可能な機能の概要

Merchant API MCP アクセス サービスを使用すると、エージェントを使用して次のアクションを実行できます。

• 正確なリソース名を使用して、特定の商品に関する詳細なステータスとレポートのコンテキストを取得 します。
• 複数の商品を一覧表示して検索 します。
• 人気の商品のパフォーマンス指標、商品ステータス、分析情報、価格に関する分析情報、競合他社の可視性、YouTube ショッピング アフィリエイト アナリティクスをクエリ します。
• 商品の表示やプログラムへの参加に影響するアカウント単位の問題を特定 します。
• データソースのアップロード ステータスを一覧表示、作成、取得、確認 します。
• 在庫全体で商品の不承認の理由をまとめて一覧表示 します。
• 商品、画像、配送の自動改善設定を確認 します。
• 特定の Merchant Center プログラムの有効な地域、満たされていない要件、参加状況を確認 します。

スタートガイド

IDE、コーディング アシスタント、エージェントを Merchant API MCP アクセス サービスに接続するには、MCP クライアントの設定を更新します。たとえば、Google Agent Studio、Claude Desktop、Antigravity、Visual Studio Code、またはカスタム エージェント フレームワークの mcp.json ファイルを更新します。

ローカルの Merchant API MCP アクセス サービスの設定にはサービス アカウントが必要 です。 このヘッドレスローカル実行では、標準ユーザーの OAuth はサポートされていません 。サービス アカウントを作成し、その JSON 秘密鍵ファイルをダウンロードして、特定の Merchant Center ID とともに引数としてパスを指定する必要があります。

サービス アカウントを作成してダウンロードする方法について詳しくは、 サービス アカウント ガイドをご覧ください。

クライアントの構成

構成の設定:

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

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

使用シナリオの例

Merchant API MCP アクセス サービスを活用してエージェント エクスペリエンスと自動ワークフローを構築する方法を示すため、次のシナリオについて考えてみましょう。

シナリオ 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 の UI を操作せずに、最近のパフォーマンスをすばやく確認したいと考えています。

ユーザーによるプロンプト:

「先週のクリック数で上位 5 件の商品を表示してください。」

MCP を使用したエージェントの動作:

1. エージェントは、product_performance_view テーブルをターゲットとし、clicks DESC で並べ替え、5 に制限する Merchant Center Query Language（MCQL）クエリを作成します。
2. エージェントは、作成したクエリで report_search を呼び出します。
3. MCP サーバーは、ライブ レポート データベースに対してクエリを実行し、行を返します。
4. エージェントは、結果をわかりやすい Markdown テーブルにフォーマットします。

シナリオ 4: データソースを作成して取得する

商品の更新をアップロードするために、新しいデータソースを追加したいと考えています。

ユーザーによるプロンプト:

「販売者アカウントに 'price-updates' という名前の補助データソースを作成してください。」

MCP を使用したエージェントの動作:

1. エージェントは、指定された設定で create_data_source を呼び出して、新しいフィードを登録します。
2. MCP サーバーはデータソースを作成し、一意のリソース名を返します。
3. エージェントは fetch_data_source を呼び出して、関連ファイルのダウンロードと処理をトリガーします。
4. エージェントは get_file_upload を呼び出して、アップロードの進行状況をモニタリングし、商品アイテムの処理ステータスが正常に完了したことを確認します。

MCP ツールと説明

Merchant API MCP アクセス サービスは、次のツールをエージェントに公開します。