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 Access Service は、セキュリティを最優先に設計されています。

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

重要な考慮事項

Merchant API MCP Access Service はアルファ版です。スコープと機能は拡張され、変更される可能性があります。

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

変更とリリース

変更は予告なく行われることがあり、リリースノートに公開されます。

安全なテスト

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

共有割り当て

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

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

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

利用可能な機能の概要

Merchant API MCP Access Service を使用すると、次のアクションをエージェント方式で実行できます。

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

スタートガイド

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

ローカルの Merchant API MCP Access Service の設定にはサービス アカウントが必要です。このヘッドレス ローカル実行では、標準ユーザー 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 アクセス サービスは、次のツールをエージェントに公開します。