Google Search ConsoleをAIエージェントに安全に連携する｜権限・承認・監査の設計

Google Search ConsoleをAIエージェントにつなぐと、検索クエリの分析、順位変動の検出、SEO改善案の提示を自動化できます。Search Consoleは参照中心のツールですが、複数サイトを扱うなら参照範囲をプロパティ単位に絞り、アクセスを監査することが必要です。

Google Search Console連携でまず起きる問題

Google Search ConsoleをそのままAIエージェントに渡すと、典型的に次の問題が起きます。

OAuthトークンの散在：プロンプトやローカルのMCP設定に置いた認証情報は、漏れたときにGoogle Search Consoleの操作が丸ごと露出します。
読み取りと書き込みが同じ扱い：参照も更新も、エージェントから見れば同じ「ツール呼び出し」です。区別がなければ、AIは同じ気軽さで実行します。
サイト横断の過剰参照：複数サイトを1ワーカーに開放すると、担当外のサイトデータまで参照できてしまいます。

参照範囲をプロパティ単位で絞る

Search Consoleは読み取り中心ですが、どのサイト（プロパティ）を参照させるかはロールで絞ります。

自由に実行してよい（読み取り・分析）：検索アナリティクスの取得、サイト一覧、クエリ・ページ・順位の分析。SEO分析はここで完結します。
範囲を絞る・承認を挟む：参照対象のサイトをロールで限定し、参照アクセスも監査ログに残す。担当サイトだけに絞ります。

こうしておけば、AIエージェントは分析や下書きまで一人で走り切り、担当プロパティだけを参照させ、アクセスの記録を残す運用になります。

生のOAuthトークンをエージェントに渡さない

もう一つの要点は認証情報の置き場所です。Google Search ConsoleのOAuthトークンをエージェントのランタイムやプロンプトに置くのは避けます。認証情報はサーバー側に暗号化して保管し、エージェントにはスコープ付きの権限トークンを1つだけ渡す。こうすれば、あるワーカーのトークンが漏れても、失効はそのワーカーの範囲に限定でき、Google Search Console本体の認証情報を作り直す必要はありません。

すべての操作を監査ログに残す

検索データを扱う以上、「どのワーカーが・どのサイトを・いつ参照したか」を後から追えることが重要です。承認された操作もブロックされた操作も、ワーカー・ロール・ツール・接続・リクエスト・結果まで記録しておけば、後からの調査や説明責任にそのまま使えます。

Grantryでの実現方法

Grantryは、AIエージェントと業務ツールの間に入る権限レイヤーです。 Google Search Consoleを含むMCP対応のサービスに対して、ワーカーごとにスコープ付きトークンを1つ発行し、読み取りは自由に、検索データ参照などの書き込みは承認ゲート越しに、そして全コールを監査ログに残します。 Claude CodeやCodexなどのMCPクライアントを、ワーカートークン付きでGrantryのエンドポイントに向けるだけで、エージェント側のコード変更なしに始められます。

よくある質問

AIエージェントにSearch ConsoleのOAuthトークンを直接渡しても大丈夫ですか？

推奨しません。トークンが漏れれば連携している全サイトの検索データが露出します。トークンはサーバー側に保管し、エージェントにはスコープ付きの権限トークンを1つだけ渡し、参照できるサイトをロールで絞るのが安全です。

複数サイトのうち担当サイトだけをAIに分析させられますか？

できます。ロールとスコープで対象プロパティを限定すれば、AIワーカーが参照できるサイトを担当分だけに絞れます。誰がどのサイトを参照したかは監査ログに残ります。

GA4と合わせてSEO分析を自動化できますか？

できます。Search ConsoleとGA4はいずれもMCP対応で、同じ権限レイヤーの後ろに置けます。分析はAIに任せつつ、プロパティやサイトごとに参照範囲を分けられます。