GSC & Bing Webmaster MCP — No API Keys for Google

gsc-bing-mcp

AI エージェント（Claude、Cline）がGoogle Search ConsoleとBing Webmaster Toolsの検索パフォーマンスデータに直接アクセスできるMCP（Model Context Protocol）サーバーです。

Google の API キーは不要 — 既存の Chrome ブラウザーセッションを使用します。
Bing のセットアップは 30 秒 — ダッシュボードから無料のキーを 1 つコピーするだけです。

v0.2.1 — ツールは合計 23 個（GSC 11 個 + Bing 11 個 + ユーティリティ 1 個）

---

✨ 特長

Google Search Console ツール（11 個）

ツール	説明
gsc_list_sites	確認済みの GSC プロパティをすべて一覧表示
gsc_performance_trend	日別のクリック数、表示回数、CTR、掲載順位の推移
gsc_top_queries	クリック数の多い検索クエリ
gsc_top_pages	クリック数の多いランディングページ
gsc_search_analytics	クエリ、ページ、国、デバイス別にグループ化した分析データ
gsc_site_summary	カバレッジとインデックス登録の概要
gsc_list_sitemaps	送信済みサイトマップのステータスとエラー数
gsc_insights	Search Console の通知と注目情報
gsc_all_queries	パフォーマンスページの HTML からすべてのクエリを取得（ページネーションを回避）
gsc_index_coverage	インデックスカバレッジの詳細な統計情報
gsc_query_pages	クエリとページの相関データ

Bing Webmaster Tools（11 個）

ツール	説明
bing_list_sites	Bing Webmaster プロパティをすべて一覧表示
bing_search_analytics	日別の表示回数、クリック数、掲載順位
bing_keyword_stats	クリック数の多いキーワード
bing_crawl_stats	クロール統計、エラー、ブロックされた URL
bing_url_info	URL のクロール日、HTTP ステータス、インデックス情報
bing_page_stats	表示回数とクリック数の多いページ
bing_submit_url	インデックス登録のため、単一の URL を Bing に送信
bing_submit_url_batch	複数の URL をまとめて Bing に送信
bing_crawl_issues	Bing で発生したクロールエラーと問題
bing_url_submission_quota	1 日あたりの URL 送信可能数の残り
bing_link_counts	Bing が検出したインバウンドリンク数

ユーティリティ（1 個）

ツール	説明
refresh_google_session	キャッシュされた Chrome Cookie を強制的に更新

---

🔐 認証の仕組み

Google Search Console — セットアップ不要

このサーバーは、yt-dlp や ytmusicapi などのツールと同様に、Chrome ブラウザーの Cookie をディスクから直接読み取ります。

1. Google にログインすると、Chrome がセッション Cookie を保存します
2. このサーバーは rookiepy（Rust ベースの軽量ライブラリ）を使って Cookie を読み取ります
3. SAPISIDHASH 認証ヘッダー（SHA1(timestamp + SAPISID + origin)）を計算します
4. GSC の内部 API に、ブラウザーとまったく同じエンドポイントを使ってリクエストを送信します

要件： Chrome で Google にログインしているだけで十分です。Chrome を起動しておく必要はありません。

複数ブラウザーのサポート

サーバーはブラウザーを優先順位順に自動検出します：Chrome → Brave → Edge

環境変数で上書きできます：

BROWSER=brave           # force a specific browser
CHROME_PROFILE=/path    # override the profile directory path

Bing Webmaster Tools — 無料の API キー

Bing では、アカウントから有効期限のない API キーを無料で取得できます。

1. bing.com/webmasters にアクセスします
2. Settings → API Access をクリックします
3. Generate API Key をクリックします
4. キーをコピーして、MCP 設定に貼り付けます（下記のセットアップを参照）

---

🚀 インストールとセットアップ

前提条件

• Google アカウントにログイン済みの Chrome（または Brave／Edge）ブラウザー
• Python 3.11 以降 または uv（推奨 — Python の管理は不要）

---

オプション A：uvx でインストール（推奨 — Python のセットアップ不要）

ステップ 1：uv をインストール（初回のみ、約 10 秒）

# macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell):
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

ステップ 2：Bing API キーを取得（2 分）

1. bing.com/webmasters にアクセス → Settings → API Access
2. Generate API Key をクリックして、キーをコピーします

ステップ 3：MCP 設定に追加（30 秒）

Cline（VS Code）の場合は、MCP 設定を開いて次を追加します：

{
  "mcpServers": {
    "gsc-bing-mcp": {
      "command": "uvx",
      "args": ["gsc-bing-mcp"],
      "env": {
        "BING_API_KEY": "paste-your-bing-key-here"
      }
    }
  }
}

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）の場合：

{
  "mcpServers": {
    "gsc-bing-mcp": {
      "command": "uvx",
      "args": ["gsc-bing-mcp"],
      "env": {
        "BING_API_KEY": "paste-your-bing-key-here"
      }
    }
  }
}

ステップ 4：完了です！ Cline／Claude Desktop を再起動して、質問を始めましょう。

---

オプション B：pip でインストール

pip install gsc-bing-mcp

次に、MCP 設定に次を追加します：

{
  "mcpServers": {
    "gsc-bing-mcp": {
      "command": "gsc-bing-mcp",
      "env": {
        "BING_API_KEY": "paste-your-bing-key-here"
      }
    }
  }
}

---

オプション C：ソースから実行（開発者向け）

git clone https://github.com/codermillat/gsc-bing-mcp
cd gsc-bing-mcp
pip install -e .

MCP 設定：

{
  "mcpServers": {
    "gsc-bing-mcp": {
      "command": "python",
      "args": ["-m", "gsc_bing_mcp.server"],
      "env": {
        "BING_API_KEY": "paste-your-bing-key-here"
      }
    }
  }
}

---

オプションの環境変数

変数	説明
BING_API_KEY	Bing Webmaster API キー（Bing ツールに必須）
BROWSER	使用するブラウザーを指定：chrome、brave、または edge
CHROME_PROFILE	Chrome プロファイルディレクトリのパスを上書き

---

💬 質問の例

"What are my top 10 search queries in GSC for the last 30 days?"
"Show me the daily click trend for my site this month"
"Which pages are getting the most impressions on Google?"
"What's my average position for 'python tutorial' in Search Console?"
"List all my verified sites in Google Search Console"
"Give me all search queries for my site — not just the top 25"
"Show index coverage issues — how many pages are excluded?"
"Are there any sitemap errors on my site?"
"What are my top Bing keywords this month?"
"Show me Bing crawl errors for my site"
"Submit https://example.com/new-post to Bing for indexing"
"How many inbound links has Bing found for my site?"
"Compare my GSC vs Bing clicks for site:example.com"
"Which queries are sending traffic to which pages on my site?"

---

🛠️ ツールリファレンス

Google Search Console ツール

gsc_list_sites

GSC アカウントで確認済みのすべてのプロパティを、プロパティの種類（ドメインまたは URL プレフィックス）とともに一覧表示します。

• パラメーターは不要です

---

gsc_performance_trend

日別のパフォーマンス傾向データ（クリック数、表示回数、CTR、掲載順位）を取得します。最も信頼性の高い GSC ツールで、整然とした日別データを返します。

• site_url — 例："https://example.com/" または "sc-domain:example.com"
• search_type — "WEB"（デフォルト）、"IMAGE"、"VIDEO"、"NEWS"
• start_date (省略可) — "YYYY-MM-DD"（デフォルト：約 17 日前）
• end_date (省略可) — "YYYY-MM-DD"（デフォルト：約 3 日前。GSC のデータ反映に遅れがあるため）

---

gsc_top_queries

クリック数の多いクエリを取得します。limit=0 に設定すると、利用可能なすべてのクエリを返します。

• site_url — サイト
• limit — クエリ数（デフォルト：25、すべて取得するには 0 を使用）
• search_type — "WEB"（デフォルト）、"IMAGE"、"VIDEO"、"NEWS"
• start_date、end_date (省略可) — 期間

---

gsc_top_pages

クリック数の多いページを取得します。limit=0 に設定すると、すべてのページを返します。

• gsc_top_queries と同じパラメーター

---

gsc_search_analytics

単一のディメンションでグループ化した検索アナリティクスを取得します。

• site_url — サイト
• dimension — "query"（デフォルト）、"page"、"country"、または "device"
• search_type — "WEB"（デフォルト）、"IMAGE"、"VIDEO"、"NEWS"
• start_date、end_date (省略可) — 期間

---

gsc_site_summary

GSC プロパティのカバレッジとインデックス登録の概要（インデックス登録済みページ、エラー、警告、除外 URL）を取得します。

• site_url — サイト

---

gsc_list_sitemaps

送信済みのすべてのサイトマップを、ステータス、送信数、インデックス登録数、エラー数とともに一覧表示します。

• site_url — サイト

---

gsc_insights

Search Console のインサイトと通知（ブランド関連クエリの傾向、フィルターアラート、コールアウト）を取得します。

• site_url — サイト

---

gsc_all_queries

パフォーマンスページの HTML をスクレイピングして、GSC からすべての検索クエリを抽出します。RPC のページネーションの制限を回避でき、gsc_top_queries より大幅に多くのクエリを返す場合があります。

• site_url — サイト
• search_type — "WEB"（デフォルト）、"IMAGE"、"VIDEO"、"NEWS"

---

gsc_index_coverage

詳細なインデックスカバレッジ統計（インデックス登録済みページ、エラー、警告、カテゴリ別の除外 URL）を取得します。

• site_url — サイト

---

gsc_query_pages

クエリとページの相関関係を表示します。どのページがどのクエリでランクインしているかを、クリック数、表示回数、CTR、掲載順位とともに確認できます。

• site_url — サイト
• search_type — "WEB"（デフォルト）、"IMAGE"、"VIDEO"、"NEWS"
• limit — 最大行数（デフォルト：50、すべて取得するには 0 を使用）

---

Bing Webmaster Tools

bing_list_sites

Bing Webmaster アカウントのすべてのサイト／プロパティを一覧表示します。

• パラメーターは不要です

---

bing_search_analytics

Bing の日次検索パフォーマンス（表示回数、クリック数、平均クリック順位）。

• site_url — Bing Webmaster Tools に表示されるサイト URL
• start_date — "YYYY-MM-DD"
• end_date — "YYYY-MM-DD"
• limit — 最大行数（デフォルト：100）

---

bing_keyword_stats

Bing からのトラフィックをもたらす上位キーワード。クリック数順に並べ替えられます。

• site_url、start_date、end_date、limit

---

bing_crawl_stats

エラー、ブロックされた URL、DNS／接続の問題などのクロール統計。

• site_url

---

bing_url_info

特定の URL に関する詳細情報（クロール日、HTTP ステータス、インデックス登録状況）。

• site_url — Bing Webmaster Tools に登録されているサイト
• page_url — 確認する特定の URL

---

bing_page_stats

表示回数、クリック数、平均クリック順位を含む上位ページ。

• site_url
• limit — 最大ページ数（デフォルト：100）

---

bing_submit_url

インデックス登録のために、単一の URL を Bing に送信します。まず bing_url_submission_quota でクォータを確認してください。

• site_url
• url — 送信するページ URL

---

bing_submit_url_batch

複数の URL を 1 回のバッチリクエストで Bing に送信します。

• site_url
• urls — カンマ区切りの URL リスト

---

bing_crawl_issues

Bing が検出したクロールの問題とエラー（HTTP エラー、DNS、robots.txt によるブロックなど）。

• site_url

---

bing_url_submission_quota

1 日あたりの URL 送信クォータの残りを確認します。

• site_url

---

bing_link_counts

Bing がサイトについて検出した被リンク数。

• site_url

---

ユーティリティ

refresh_google_session

キャッシュされた Chrome の Cookie を強制的に更新します。最近 Google に再ログインしてツールが動作しなくなった場合に使用してください。

• パラメーターは不要です

---

⚠️ トラブルシューティング

「Google セッション Cookie が見つかりません」

• Chrome で Google にログインしていることを確認してください
• Chrome を開いて google.com にアクセスし、必要に応じてログインしてください
• refresh_google_session を呼び出してから、再試行してください

「Chrome の Cookie データベースがロックされています」

• Chrome がデータベースに書き込み中の可能性があります。数秒待ってから再試行してください。
• macOS では、Chrome の起動直後または終了直後に発生することがあります。

「Chrome の Cookie の読み取りが拒否されました」（macOS）

• ターミナルまたは IDE にフルディスクアクセスを許可してください：
  • システム設定 → プライバシーとセキュリティ → フルディスクアクセス → ターミナル／VS Code を追加

「BING_API_KEY 環境変数が設定されていません」

• MCP 設定の env セクションに "BING_API_KEY" を追加してください
• 設定を更新した後、Cline／Claude Desktop を再起動してください

GSC データに「データが見つかりません」と表示される

• GSC のデータには約 2～3 日の遅延があります。end_date は少なくとも 3 日前の日付にしてください
• site_url が GSC の表示と完全に一致していることを確認してください（末尾のスラッシュも含みます）

Chrome の代わりに Brave または Edge を使用していますか？

• MCP 設定の env セクションで BROWSER=brave または BROWSER=edge を設定してください

---

📦 依存関係

パッケージ	用途	サイズ
mcp	MCP プロトコルサーバー（FastMCP）	約5MB
rookiepy	Chrome／Brave／Edge の Cookie リーダー（Rust ベース）	約2MB
httpx	非同期 HTTP クライアント	約3MB

インストール後の合計：約10MB、実行時の RAM 使用量：約15MB

Playwright は不要です。Chrome バイナリも不要です。ブラウザーの自動操作もありません。

---

🔒 プライバシーとセキュリティ

• すべてのデータはローカルに保持されます — このサーバーはお使いのマシン上で動作し、コンピューターから直接 API 呼び出しを行います
• 第三者にデータが送信されることはありません — Cookie や検索データがお使いのマシンから外部に送られることはありません
• Cookie は読み取り専用です — このサーバーは Cookie を読み取るだけで、変更することはありません
• 機密データはログに記録されません — Cookie の値がログに記録されることはありません

---

📡 更新を公開する方法（開発者向け）

# Edit version in pyproject.toml and gsc_bing_mcp/__init__.py, then:
pip install build twine
python -m build
twine upload dist/*

ユーザーは次回 uvx を実行したときに、自動的に更新を取得します。

---

📝 ライセンス

MIT — 個人利用および商用利用は無料です。