Skip to main content
Glama
ga-gsc-analytics

ga-gsc-analytics

ga-gsc-analytics

読み取り専用のMCPサーバーで、Google Analytics 4 と Google Search Console のデータ(analytics.readonly + webmasters.readonly スコープ)を Claude Code / Codex に公開します。

初めての方へ? ONBOARDING.md に従って、ゼロから動作するまでの手順(Claude Code のインストール、認証情報の取得、認可、確認)を進めてください。このファイルの残りは参考資料です。

AIエージェント向け: このファイルは AGENTS.md を兼ねています。セットアップはここから始め、ツールの使い方(アクセスチェック、デフォルトの日付範囲、GA4 と GSC の意味論、プレゼンテーション引き継ぎ形式)については skills/analyze-ga-gsc/SKILL.md を読んでください。ユーザーにチャットで認証情報を貼り付けさせないでください。

ツール

  • analytics_auth_start / analytics_auth_status — ローカルOAuthフローとステータス確認

  • analytics_list_sources — 認可されたアカウントで利用可能な GA4 プロパティと GSC サイトを一覧表示

  • ga_run_report — GA4 レポートを実行

  • gsc_query_search_analytics — Search Console データを照会

  • analytics_presentation_snapshot — レポート用の GA4 + GSC の複合スナップショット

Related MCP server: GSC MCP

セットアップ(ユーザーごと)

各ユーザーは自分の Google アカウントで認可し、自分のローカルトークンを保持します。client_secret.json のシークレットや tokens.json をマシン間で共有しないでください。

  1. Google Cloud OAuth クライアント: Google Cloud Console で OAuth 2.0 デスクトップクライアントを作成(または既存を再利用)し、その client_secret.json をダウンロードします。同意画面が「テスト中」の公開ステータスの場合、先に各新規ユーザーの Google アカウントをテストユーザーとして追加しないと、認可がアクセス拒否で失敗します。

  2. 認証情報を配置: ~/.config/ga-gsc-analytics/client_secret.json に配置します(または GA_GSC_CLIENT_SECRET でカスタムパスを指定)。

  3. データアクセスを付与: 認可する Google アカウントには、対象の GA4 プロパティ(Analytics Admin → プロパティのアクセス管理)と GSC サイト(Search Console → 設定 → ユーザーと権限)に対する実際の権限が必要です。

  4. サーバーをビルド(mcp/server.mjs を変更した場合のみ必要。リポジトリにはビルド済みの mcp/server.bundle.cjs が同梱されています):

pnpm install
pnpm run build   # bundles mcp/server.mjs -> mcp/server.bundle.cjs
  1. MCP サーバーを登録。次のいずれかで行います:

    • Claude Code、ユーザーレベル: claude mcp add ga-gsc-analytics -- node /path/to/ga-gsc-analytics/mcp/server.bundle.cjs

    • Claude Code / Codex、プロジェクトスコープ: このリポジトリには相対パスの .mcp.json({"mcpServers": {"ga_gsc_analytics": {"command": "node", "args": ["./mcp/server.bundle.cjs"]}}})が同梱されています。これをプロジェクトにコピーするか、このフォルダ全体をシンボリックリンクまたはベンダーとして取り込むと、そのプロジェクトを開いたときに自動的に認識されます。

  2. 認可: AI ツール内から analytics_auth_start ツールを呼び出します。ローカルブラウザの OAuth フローが開き、~/.config/ga-gsc-analytics/tokens.json に書き込まれます。

  3. 確認: analytics_auth_status を呼び出し(authorized: true と表示されるはず)、次に analytics_list_sources を呼び出して、期待する GA4 プロパティ / GSC サイトが表示されることを確認します。

設定の上書き

環境変数

デフォルト

GA_GSC_CONFIG_DIR

~/.config/ga-gsc-analytics

GA_GSC_CLIENT_SECRET

$GA_GSC_CONFIG_DIR/client_secret.json

GA_GSC_TOKEN_PATH

$GA_GSC_CONFIG_DIR/tokens.json

開発

pnpm run check   # syntax check
pnpm test        # node --test tests/*.test.mjs

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Read-only access to Google Analytics 4 reporting data, including traffic overview, top pages, traffic sources, and conversion events, supporting custom report queries via MCP.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only access to Google Search Console data, including property discovery, search analytics queries, and URL inspection, through a security-focused interface.
      3
      2,636 PyPI
      2
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only access to Google Analytics 4, Google Search Console, BigQuery saved queries, GitHub repository data, and Metricool status for SEO/SEM monitoring and analysis.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only access to Google Search Console data, including search analytics, sitemap status, URL inspection, and property listing.
      4
      25 npm
      MIT