Google Search Console MCP Server

Google Search Console MCP サーバー

分析機能を強化し、Google Search Console のデータに包括的にアクセスできる Model Context Protocol（MCP）サーバーです。

機能

• 検索分析の強化：パフォーマンスデータを最大 25,000 行取得します
• 高度なフィルタリング：正規表現パターンと複数のフィルター演算子に対応します
• クイックウィンの検出：最適化の機会を自動的に特定します
• 豊富なディメンション：クエリ、ページ、国、デバイス、検索での見え方を分析します
• 柔軟な日付範囲：過去のデータにもアクセスできる、カスタマイズ可能なレポート期間を指定できます

スポンサー

macuse.app は、AI アシスタントをカレンダー、メール、メモなどの macOS アプリと連携させ、あらゆるアプリをユニバーサルに UI 操作できるようにする、ネイティブ macOS アプリケーションです。ワンクリックでセットアップでき、Claude Desktop、Cursor、Raycast に対応しています。プライバシーを最優先し、ローカルで動作します。

前提条件

• Node.js 18 以降
• Search Console API を有効にした Google Cloud プロジェクト
• Search Console へのアクセス権を持つサービスアカウントの認証情報

インストール

npm install mcp-server-gsc

認証の設定

Google Search Console API の認証情報を取得するには、次の手順に従います。

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. API を有効にします：

• 「API とサービス」>「ライブラリ」に移動します
• "Search Console API" を検索して有効にします

4. 認証情報を作成します：

• "API とサービス" > "認証情報" に移動します
• 「認証情報を作成」>「サービスアカウント」をクリックします
• サービスアカウントの詳細を入力します
• JSON 形式の新しいキーを作成します
• 認証情報ファイル（.json）が自動的にダウンロードされます

5. アクセス権を付与します：

• Search Console を開きます
• サービスアカウントのメールアドレス（形式：[email protected]）をプロパティの管理者として追加します

使い方

Claude Desktop の設定

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

利用可能なツール

search_analytics

分析機能を強化し、Google Search Console から包括的な検索パフォーマンスデータを取得します。

必須パラメーター：

• siteUrl：サイトの URL（形式：http://www.example.com/ または sc-domain:example.com）
• startDate：開始日（YYYY-MM-DD）
• endDate：終了日（YYYY-MM-DD）

任意のパラメーター：

• dimensions：カンマ区切りのリスト（query、page、country、device、searchAppearance、date）
• type：検索タイプ（web、image、video、news、discover、googleNews）
• aggregationType：集計方法（auto、byNewsShowcasePanel、byProperty、byPage）
• rowLimit：返す最大行数（デフォルト：1000、最大：25000）
• dataState：データの鮮度（all または final、デフォルト：final）

フィルターパラメーター：

• pageFilter：ページ URL でフィルター（regex: 接頭辞を使った正規表現に対応）
• queryFilter：検索クエリでフィルター（regex: 接頭辞を使った正規表現に対応）
• countryFilter：ISO 3166-1 alpha-3 の国コードでフィルター（例：USA、CHN）
• deviceFilter：デバイスタイプでフィルター（DESKTOP、MOBILE、TABLET）
• searchAppearanceFilter：検索機能でフィルター（例：AMP_BLUE_LINK、AMP_TOP_STORIES）
• filterOperator：フィルターの演算子（equals、contains、notEquals、notContains、includingRegex、excludingRegex）

クイックウィンの検出：

• detectQuickWins：最適化の機会を自動的に検出します（デフォルト：false）
• quickWinsConfig：クイックウィン検出の設定：
  • positionRange：対象とする掲載順位の範囲（デフォルト：[4, 20]）
  • minImpressions：インプレッション数の最小しきい値（デフォルト：100）
  • minCtr：CTR の最小パーセンテージ（デフォルト：1）

例 — 基本的なクエリ：

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "rowLimit": 5000
}

例 — 正規表現を使った高度なフィルタリング：

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "page,query",
  "queryFilter": "regex:(AI|machine learning|ML)",
  "filterOperator": "includingRegex",
  "deviceFilter": "MOBILE",
  "rowLimit": 10000
}

例 — クイックウィンの検出：

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "detectQuickWins": true,
  "quickWinsConfig": {
    "positionRange": [4, 15],
    "minImpressions": 500,
    "minCtr": 2
  }
}

ライセンス

MIT

貢献

貢献を歓迎します！プルリクエストを送信する前に、貢献ガイドラインをお読みください。