Google Business Profile MCP

Google Business Profile MCP

英語 | ロシア語

A1 Google Business Profile MCP を使うと、AI アプリから自然言語で Google Business Profile のロケーションを操作できます。ロケーションやパフォーマンスの確認、クチコミへの返信、ローカル投稿の準備、プロフィール情報の意図的な更新ができます。

Google の現行の Business Profile API と、クチコミや投稿が引き続き利用できるレガシー API に接続します。Google アカウントと OAuth 認証情報だけでは不十分です。Google による Cloud プロジェクトの Basic API Access の承認が必要です。

• 20 個のツール。 ロケーションとアカウントのデータ、パフォーマンス、クチコミ、ローカル投稿、カテゴリ、属性を扱います。
• 実際の承認ゲート。 プロジェクトは 0 QPM から開始し、Google が Basic API Access の申請を承認するまで、すべての API 呼び出しが失敗します。
• 独立した公開境界。 準備した返信、投稿、ロケーションの更新は、クライアントが書き込み操作を確認した後にのみ、公開されているビジネス情報に反映されます。
• 4 つの API サーフェス。 Account Management、Business Information、Performance、レガシー v4 を、1 つの business.manage OAuth スコープで利用できます。

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

自分のロケーションを一覧表示し、返信のない最新のクチコミを表示してください。

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

1 分で動作を確認

あなた： 自分のロケーションを一覧表示し、返信のない最新のクチコミを表示してください。

アシスタント： ロケーションと最近のクチコミを表示します。何も変更されません。

あなた： ダウンタウンのロケーションにある最新の星 3 つのクチコミに返信する文章を作成してください。お詫びを伝え、サポートを申し出てください。

アシスタント： ロケーション、クチコミ、返信案を表示し、公開する前に確認を求めます。

あなた： 確認します。

アシスタント： 返信を公開します。クチコミ、ほかのロケーション、投稿は変更しません。

目次

• クイックスタート
• できること
• 変更される内容
• アクセスの取得
• 設定
• データ、制限、バックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20 以降、確認済みの Google Business Profile、Google Cloud OAuth クライアント、承認済みの Basic API Access アプリケーションが必要です。

1. アクセスの承認を受ける。
2. AI アプリにサーバーを追加します。
3. 上記の読み取り専用の質問から始めます。

codex mcp add google-business \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-business@latest
codex mcp list

claude mcp add \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-business \
  -- npx -y mcp-google-business@latest
claude mcp list

{"mcpServers":{"google-business":{"command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}}

{"servers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"${input:gbp_client_id}","GOOGLE_BUSINESS_CLIENT_SECRET":"${input:gbp_client_secret}","GOOGLE_BUSINESS_REFRESH_TOKEN":"${input:gbp_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gbp_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gbp_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gbp_refresh_token","description":"Google OAuth refresh token","password":true}]}

実行できる操作

• ビジネス拠点、カテゴリ、属性、現在のプロフィール情報を一覧表示します。
• 指定した期間の通話、ルート検索、検索キーワードのインプレッションを表示します。
• 新しいクチコミを見つけて返信の下書きを作成し、確認後に公開します。
• ローカル投稿を作成、更新、削除します。
• 変更内容を正確に表示したうえで、指定したビジネス拠点の項目または属性を更新します。

変更される内容

確認の制御は AI クライアントが行います。サーバーは、クライアントが情報の確認と実際の変更を区別できるように、ツールにマークを付けます。

アクセスの取得

Google では、OAuth と Basic API Access の両方について承認が必要です。

1. 60 日以上運用されている、確認済みで有効なビジネス プロフィールを使用します。オーナーまたは管理者のアカウントから申請し、申請内容と一致するビジネスウェブサイトを用意してください。
2. Google Cloud プロジェクトを作成し、My Business Account Management API、Business Information API、Business Profile Performance API、Google My Business API（legacy v4）を有効にします。
3. GBP API contact form から Application for Basic API Access として申請します。承認前の割り当て量は 0 QPM です。承認されたプロジェクトでは、API ごとに 300 QPM が付与されます。
4. OAuth クライアントを作成し、https://www.googleapis.com/auth/business.manage のリフレッシュトークンを取得して、3 つの GOOGLE_BUSINESS_* 変数を設定します。

クライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。アクセストークンは、1 回限りの使用に適した有効期間の短い代替手段です。

設定

* OAuth の 3 つの値、またはアクセストークンのいずれかを指定してください。API ホストのオーバーライドについては、ツールリファレンスを参照してください。

データ、制限、バックグラウンド処理

• プロフィールへのリクエストは Google に送信されます。 匿名テレメトリには、インストール情報とバージョン情報、およびツール名が含まれますが、OAuth シークレット、プロフィールデータ、引数、プロンプトは含まれません。オプトアウトするには、ASKADS_TELEMETRY=0 を設定してください。
• 実際の編集上限があります。 承認されたプロジェクトでは API ごとに 300 QPM が付与されます。また、Google は各ビジネス プロフィールの編集を 1 分あたり 10 件に制限しています。パフォーマンス指標の反映には数日かかる場合があり、クチコミへの返信には確認済みのビジネス拠点が必要です。
• バックグラウンドでの監視はありません。 サーバーは呼び出されたときのみ実行されます。AI アプリがスケジュール済みタスクに対応している場合は、新しいフィードバックや指標を定期的に確認できます。

技術ドキュメント

• MCP 機能カタログ — すべてのツールについて、タスク別に説明したページです。
• すべてのツールと入力
• 開発ドキュメント
• 公開ドキュメント
• Google Business Profile API ドキュメント

サポート

バグを見つけた場合や、対応してほしいシナリオがある場合は、イシューを作成するか、Telegramでご連絡ください。

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