Google Search Console Connector

Claude Code 向け Google Search Console コネクター

Claude Code、Google Antigravity、または任意の MCP クライアントから、どのウェブサイトのプロジェクトも Google Search Console に接続できます。Google アカウントに一度ログインすれば、クリック数、検索クエリ、順位、インデックス登録について Claude に質問したり、コマンドひとつで GSC のすべてのレポートを CSV として取得したり、ローカル SEO ダッシュボードですべてを追跡したりできます。

これはオープンソースの Search Console MCP サーバー、GSC レポートエクスポーター、ダッシュボードで、すべてお使いのコンピューター上で動作します。Google Cloud の設定も API キーも不要です。Google にログインするだけです。

役に立ったと思ったら、GitHub で ⭐ を付けていただけると、ほかの人にも見つけてもらいやすくなります。

ドキュメントと最新情報： claude-repo.com/google-search-console-connector

---

このツールを作った理由

AI コーディングエージェントを使ってサイトを構築している場合、Search Console のデータを取り込むには通常、search.google.com にログインし、エクスポートをクリックして、CSV をダウンロードし、チャットにドラッグして読み込ませる必要があります。サイトごとに、毎回同じ作業です。

このツールを使えば、そうした手順は不要になります。

npx google-search-console-connector report

このコマンドひとつで、Search Console のエクスポートボタンと同じレポート（日付、検索クエリ、ページ、国、デバイス、検索での見え方）に加え、前の期間との比較、検索クエリとページの組み合わせ、サイトマップ、Claude が読み取れる形式で書かれた summary.md をダウンロードできます。Claude Code では、コマンドを入力する必要さえありません。「Search Console のレポートを取得して」と頼めば、Claude が gsc_export_report ツールを実行します。

機能

• Google でログイン。 Google 独自の OAuth 2.0（PKCE）を使い、ブラウザーでワンクリックするだけです。Google Cloud プロジェクト、API キー、パスワードは不要です。
• コマンドひとつで GSC をエクスポート。 --all-sites を使って 1 つまたはすべてのサイトの CSV、JSON、Markdown レポートを、最大 16 か月の任意の期間で取得できます。
• Claude Code と Antigravity 向け MCP サーバー。 18 個のツールを備えています。パフォーマンスデータ、時間単位のデータ、ブランド検索クエリと非ブランド検索クエリ、URL 検査、サイトマップ、プロパティの追加、所有権の確認に対応しています。
• ローカル SEO ダッシュボード。 前の期間と比較した KPI、推移グラフ（時間単位、日単位、週単位、月単位）、検索クエリ、ページ、国、デバイス、サイトマップ、URL 検査を確認できます。ライトテーマとダークテーマに対応しています。
• 改善の機会。 上位表示が見込めるキーワード（掲載順位 4～20 位）、CTR が低い 1 ページ目のページ、クリック数が減少している検索クエリを確認できます。
• ブランド検索と非ブランド検索。 ブランド用語を一度設定すれば、ダッシュボード、レポート、Claude ですべて、それらに基づいてトラフィックを分類できます。
• グラフへのメモ。 SEO の変更を反映したとき（「サービスページのタイトルを書き直しました」など）に、Claude がグラフにマークを付けられるため、数値の変化を確認できます。
• サイトの所有権確認。 Claude が新しいサイトを Search Console に追加し、確認用メタタグをコードに挿入して、デプロイ後に所有権を確認できます。
• Google の最新機能に対応。 時間単位のデータ、Discover、Google ニュースなど、Search Console API の最新機能に対応しています。週次チェックで、新しい API フィールドと Search Central のお知らせを確認できます。
• デフォルトでプライベート。 トークンと Search Console のデータはお使いのコンピューター内に保管され、Google にのみ送信されます。間にサーバーはありません。

クイックスタート

Node.js 20 以降と、Search Console にアクセスできる Google アカウントが必要です。

1. Claude Code に追加します（一度設定すれば、すべてのプロジェクトで使えます）。

claude mcp add gsc --scope user -- npx -y google-search-console-connector@latest

Windows では、npx を cmd /c で囲みます。

claude mcp add gsc --scope user -- cmd /c npx -y google-search-console-connector@latest

npm ではなく、GitHub から最新のコードを直接実行するには、npx -y google-search-console-connector@latest の代わりに npx -y github:malaysherasia-ai/google-search-console-connector-for-claude-code を使います。初回起動時はビルドに約 20 秒かかります。GitHub ビルドにはワンクリックのサインインクライアントが含まれていないため、ご自身の Google Cloud OAuth クライアントが必要です（Connect ページで設定方法を確認できます）。

2. ウェブサイトのプロジェクトを接続します。 ウェブサイトのフォルダーで Claude Code を開き、次のように伝えます。

このプロジェクトを Google Search Console に接続して

Claude が gsc_connect を呼び出すと、ブラウザーでページが開きます。

1. 匿名の使用状況指標に関する一度限りの質問（「はい」か「いいえ」を選択できます）、
2. Search Console にアクセスできるアカウントで Google にサインイン します。Google の 2 つ目の画面で、[続行] をクリックする前に、「確認済みのサイトの Search Console データの表示と管理」の横にある チェックボックスにチェックを入れてください。Google ではチェックが入っていません。
3. このプロジェクトに該当する Search Console のプロパティを選択します。

Google に表示される画面（アカウントの詳細は非表示）：

これで完了です。Google がアプリのブランディングを確認済みで、要求する権限も機密性の高いものではないため、クリックして進む必要のある「未確認のアプリ」画面は表示されません。チェックボックスにチェックを入れずに続行すると、コネクターは以前のサインイン状態を保持し、もう一度試すよう求めます。

3. 何でも聞いてみましょう。

過去 28 日間のサイトのパフォーマンスはどうでしたか？ 検索順位が 4〜20 位のクエリと、改善すべきページを教えてください。 過去 3 か月分の GSC レポートを取得してください。 https://example.com/services/ を調べて、インデックス登録されていない理由を教えてください。 サイトマップを送信してから、新しい地域ページを公開したことを示すグラフの注釈を追加してください。 Search Console のダッシュボードを開いてください。

すべての操作はターミナルからも実行できます。

npx google-search-console-connector connect     # browser setup and sign-in
npx google-search-console-connector report      # export reports to .gsc-reports/
npx google-search-console-connector dashboard   # open the local dashboard
npx google-search-console-connector demo        # try the dashboard with sample data

Google Antigravity、Cursor、その他の MCP クライアントで使用する

ローカル（stdio）サーバーを起動できる MCP クライアントなら、どれでも使用できます。MCP 設定に次の内容を追加してください（Antigravity では、MCP サーバーの設定を開き、設定ファイルを直接編集します）。

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": ["-y", "google-search-console-connector@latest"]
    }
  }
}

サーバーは、起動したフォルダーをプロジェクトとして使用します。クライアントが別の場所でサーバーを起動する場合は、"env": { "GSC_PROJECT_DIR": "/path/to/your/site" } を設定してください。

上級者向け：独自の Google Cloud プロジェクトを使用する

ほとんどの方はこの手順を省略できます。独自の Google Cloud プロジェクト（独自の割り当て量、独自の同意画面）を通じてサインインしたい代理店や開発者は、サインインページで Use my own Google Cloud project を選択できます。手順は次のとおりです。

1. Google Cloud プロジェクトを作成するか、既存のプロジェクトを選択します。
2. Google Search Console APIを有効にします。
3. Site Verification API（新しいサイトの確認に使用）を有効にします。
4. 同意画面を設定します。External を選択し、自分のメールアドレスをテストユーザーとして追加します。その後、アプリを In production に公開します。「Testing」のままのアプリでは、サインインの有効期限が 7 日ごとに切れます。自分で使用する場合、Google によるアプリの確認は不要です。Google に「未確認のアプリ」という通知が表示されますが、Advanced → Go to (your app) を選択して続行します。
5. Desktop app タイプの OAuth クライアント ID を作成し、JSON をダウンロードして、Connect ページにドロップします。

どちらの API も無料です。独自のクライアントを使用すると、割り当て量と同意画面は自分のものになります。組み込みのサインインに戻すには、そのページの上部にあるリンク、またはダッシュボードの Settings を使用します。

ワンコマンドで Search Console レポートを作成

npx google-search-console-connector report [--days 28] [--type web] [--site URL] [--all-sites] [--out DIR]

ファイル	内容
summary.md	前の期間との合計の比較、ブランド別の内訳、上位のクエリとページ、最大の増加と減少、上位表示が目前のキーワード、CTR の低いページ
Dates.csv、Queries.csv、Pages.csv、Countries.csv、Devices.csv、Search appearance.csv	Search Console のエクスポートと同じ列に、前の期間の列を追加したもの
Query-page pairs.csv	どのクエリでどのページがランク付けされているか（Search Console の UI ではエクスポートできません）
Sitemaps.csv	送信済みサイトマップ、ステータス、エラー、警告
Filters.csv、report.json	リクエスト内容と、JSON 形式の全データ

レポートはプロジェクト内の .gsc-reports/<site>/<date>_last-<n>-days/ に出力されます。また、検索データがコミットやデプロイ済みサイトに含まれないよう、.gsc-reports/ が .gitignore に追加されます。Google の 25,000 行の上限を超えるデータは、自動的にページ分割して取得します。

MCP ツール

ツール	機能
gsc_connect	ブラウザーで Connect フローを開き、完了するまで待機します
gsc_status / gsc_disconnect	接続状態の確認、アクセス権の取り消し
gsc_list_sites / gsc_link_project	プロパティの一覧表示、このプロジェクトのデフォルトプロパティの設定
gsc_performance_summary	前の期間との合計の比較と、上位のクエリおよびページ
gsc_search_analytics	hour などのディメンション、フィルター（正規表現）、検索タイプ、ブランド／非ブランドを指定できる、任意の Search Analytics クエリ
gsc_export_report	1 つまたはすべてのサイトを対象とした、ワンコマンドでのレポートのエクスポート
gsc_inspect_url	URL 検査：インデックス登録状況、最終クロール、正規 URL、リッチリザルト
gsc_list_sitemaps / gsc_submit_sitemap / gsc_delete_sitemap	サイトマップの管理
gsc_add_site / gsc_get_verification_token / gsc_verify_site	プロパティの追加と所有権の確認（メタタグ、HTML ファイル、DNS）
gsc_set_brand_terms	クエリを「ブランド」と判定する単語
gsc_add_annotation	パフォーマンスグラフに日付付きのメモを追加
gsc_open_dashboard	ローカルダッシュボードを開く

ダッシュボード

npx google-search-console-connector dashboard を実行するか、Claude に開くよう依頼してください。127.0.0.1 のみで動作し、1 回限りのリンクから開きます。

• 概要： 前の期間と比較したクリック数、表示回数、CTR、掲載順位を表示し、過去 24 時間（時間単位）から 16 か月までのトレンドチャートを日別、週別、月別にグループ化して表示します
• クエリとページ： 並べ替え、検索、列の変更、CSV エクスポートができます
• 機会： 掲載順位が近いキーワード、CTR の低いページ、減少しているクエリを表示します
• サイトマップと検査： サイトマップの送信とステータス確認、任意の URL の検査ができます
• 設定： アカウント、プロジェクトのプロパティ、ブランド用語、チャートの注釈、使用状況メトリクスの設定

Google アカウントなしで試すには、npx google-search-console-connector demo を実行してください。

Google の API で取得できる情報とできない情報

Search Console では機能が追加され続けています。API で利用できるものもあれば、ウェブ UI のみにとどまるものもあります。この表は、2026 年 10 月時点の Google の API を反映しています。

Search Console の機能	ここでの対応状況	備考
パフォーマンス：日付、クエリ、ページ、国、デバイス、検索での見え方別のクリック数、表示回数、CTR、掲載順位	対応
時間単位のデータ（過去約 10 日間）	対応	hour ディメンション、ダッシュボードの「24h」期間
Discover と Google ニュースのパフォーマンス	対応	Google はこれらのクエリや掲載順位を報告しません
ブランド関連・非ブランド関連のクエリ	対応	RE2 正規表現フィルターを使い、ブランド用語から作成します
週次・月次表示	対応	日次データをグループ化します
チャートの注釈	対応（ローカル）	.gsc-connect.json に保存されます。Google 独自の注釈は API に含まれません
AI Overviews と AI Mode	ウェブの合計に含まれます	Google の API では個別に分離できません
生成 AI のパフォーマンスレポート、ウェブのマルチモーダル検索タイプ、ソーシャルプラットフォームのプロパティ、クエリグループ	未対応	現在の Search Console では UI でのみ利用できます。Google が API に追加すると、更新チェックによりすぐに通知されます

プライバシーと匿名の使用状況メトリクス

• Search Console のデータがコンピューターの外に送信されることはありません。 Google とのやり取りを除きます。
• トークンは ~/.gsc-connect/ に、所有者のみがアクセスできるファイル権限で保存されます。接続を解除すると、Google 側でトークンが無効になります。
• プロジェクト設定（.gsc-connect.json：プロパティ、ブランド用語、チャートの注釈）には秘密情報が含まれないため、安心してコミットできます。
• 匿名の使用状況メトリクスはオプトイン方式です。 最初の画面で一度だけ確認されます。「いいえ」を選ぶと、情報は一切送信されません。「はい」を選ぶと、アプリのバージョン、オペレーティングシステム、ランダムなインストール ID とともに、view_changed や mcp_tool_called などのイベント名が Measurement Protocol 経由で Google Analytics 4 に送信されます。サイト URL、ページ URL、クエリ、メトリクス、アカウント情報が送信されることはありません。ブラウザーでトラッキングスクリプトが実行されたり、Cookie が設定されたりすることもありません。設定 →「送信内容」では、送信されたイベントをそのまま確認でき、いつでも設定を変更できます。DO_NOT_TRACK=1 または GSC_CONNECT_TELEMETRY=0 を設定すると、恒久的に無効になります。イベントの全一覧は src/telemetry.ts にあります。
• 更新チェック： アプリは 1 日に 1 回、公開 npm レジストリに最新のバージョン番号を問い合わせます。無効にするには GSC_CONNECT_UPDATE_CHECK=0 を設定してください。

セキュリティ

• ローカルサーバーは 127.0.0.1 のみでリッスンし、Host ヘッダーを確認します。また、一度だけ使用できる起動リンクを通じて設定されるセッション Cookie を必須とします。
• OAuth では、デスクトップアプリ向けに Google が推奨する、PKCE（S256）を使用したループバックリダイレクトと state の確認を行います。
• サインイン時に要求する権限は、webmasters（Search Console）と openid email（接続中のアカウントを表示するため）です。siteverification は別途、新しいサイトを初めて確認する場合に限り要求します。

脆弱性は非公開で報告してください。詳しくは SECURITY.md をご覧ください。

設定

変数	用途
GSC_PROJECT_DIR	MCP クライアントが別の場所でサーバーを起動する場合のプロジェクトフォルダー
GSC_CLIENT_ID, GSC_CLIENT_SECRET	組み込みのサインインの代わりに、環境変数で指定した独自の OAuth クライアントを使用します
GSC_CONNECT_HOME	認証情報の保存場所（デフォルトは ~/.gsc-connect）
GSC_CONNECT_PORT	優先するローカルポート（デフォルトは 4817。使用中の場合は空いているポートを使用します）
GSC_CONNECT_TELEMETRY=0, DO_NOT_TRACK=1	使用状況の指標を送信しません
GSC_CONNECT_UPDATE_CHECK=0	npm で新しいバージョンを確認しません

よくある質問

Google Search Console API は無料ですか？ はい。Google Search Console API と Site Verification API の利用に料金はかかりません。また、このツールに有料機能はありません。

Google Cloud アカウントは必要ですか？ いいえ。Search Console ですでに使用している Google アカウントでサインインできます。独自の Google Cloud プロジェクトを使用することもできますが、これは任意の詳細設定です。

データを閲覧できるのは誰ですか？ あなたと Google だけです。サインインによってアクセスが許可されるのはサーバーではなく、あなたのコンピューターです。トークンは ~/.gsc-connect/ に保存され、レポートはプロジェクトフォルダーに保存されます。プライバシーポリシーをご覧ください。

1,000 行を超えるデータをエクスポートできますか？ はい。Search Console のウェブ版のエクスポートでは 1,000 行までですが、API では 1 リクエストあたり最大 25,000 行を取得できます。このツールはページを順次取得し、検索タイプごとの 1 日あたり 50,000 行という Google の上限まで対応します。

ドメイン プロパティ（sc-domain:）でも使えますか？ はい。ドメイン プロパティと URL プレフィックス プロパティの両方に対応しています。ドメイン プロパティは DNS で確認します。

複数のウェブサイトで使えますか？ はい。各プロジェクトフォルダーはそれぞれのプロパティに紐付けられます。また、report --all-sites を実行すると、アクセスできるすべてのプロパティをエクスポートできます。

アップデートするにはどうすればよいですか？ @latest を使用してインストールした場合は、Claude Code を再起動してください。新しいバージョンが公開されると、ダッシュボードと CLI に通知されます。

開発

git clone https://github.com/malaysherasia-ai/google-search-console-connector-for-claude-code.git
cd google-search-console-connector-for-claude-code
npm install
npm run build
npm run demo                                  # dashboard with sample data
claude mcp add gsc-dev -- node "$PWD/dist/index.js"
npm run check:google                          # what has Google changed since the last release?

Google の変更や利用状況に基づくリリース計画については RELEASING.md を、貢献方法については CONTRIBUTING.md をご覧ください。

ライセンス

MIT。Google とは提携しておらず、Google からの承認も受けていません。Google Search Console は Google LLC の商標です。