Antigravity / Claude Codeで動かすGA4・サチコMCP連携

昨日のアクセス数と最も読まれたページのURLを教えてください

サーチコンソールで検索露出が上位にあるものの、GA4でのPV数が伸び悩んでいるボトルネックページを特定してください。その上で、流入している主要な検索キーワードの意図を分析し、コンテンツに追加すべき具体的な見出し構成案を作成して

毎週月曜日の朝に、先週1週間のGA4のPV推移と、サーチコンソールの検索流入キーワード上位10件をまとめた週次レポートを作成してください

この分析レポートをPDFファイルとしてダウンロードできるように書き出してください。ファイル名は website_report_202607.pdf でお願いします

credentials.json
service-account*.json
*-credentials.json

以下の要件に従って、Google Analytics 4 (GA4) と Google Search Console のデータを取得するMCPサーバーを自動構築し、接続設定までをすべて完了させてください。

1. credentialsファイルの準備
- 事前に取得したGoogle Cloudサービスアカウントの鍵ファイル（JSON形式）が、ローカルの以下のパスに配置されていると想定します。
  パス: <あなたのプロジェクトフォルダ>/credentials.json
  （※例: /Users/yourname/projects/site-analytics/credentials.json のように、実際に鍵ファイルを置いた絶対パスに書き換えてください）

2. MCPサーバーファイルの新規作成
- ファイル名: analytics_mcp.py
- FastMCPモジュールを使用し、以下のツール関数を実装すること。
  - get_ga4_page_views(property_id, days=30): 指定したGA4プロパティIDから、過去N日間のページごとのPV数とアクティブユーザー数を取得する。
  - get_search_keywords(site_url, days=30): 指定したSearch ConsoleのサイトURLから、過去N日間の検索キーワード、表示回数、クリック数、平均掲載順位を取得する。

3. 依存ライブラリの自動インストール
- 必要なPythonパッケージ（google-api-python-client, google-auth, google-analytics-data, mcp）を自動的にインストールする。

4. エージェント設定ファイルへの自動登録
- エージェントの設定ファイル（Claude Codeの場合はプロジェクト直下の .mcp.json）に、上記で作成したMCPサーバー（analytics_mcp.py）を実行するための設定を追加する。
- 実行時の環境変数 GOOGLE_APPLICATION_CREDENTIALS に、上記の credentials.json の絶対パスを指定すること。

以上のファイルをすべて自動生成・設定し、完了したらテスト実行を行ってください。

echo 'export GEMINI_API_KEY="コピーしたAPIキー"' >> ~/.zshrc
source ~/.zshrc

python
from mcp.server.fastmcp import FastMCP
import os
from datetime import date, timedelta
from google.oauth2 import service_account
from googleapiclient.discovery import build
from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import DateRange, Dimension, Metric, RunReportRequest

# MCPサーバーの起動
mcp = FastMCP("SEO-Analytics")

# Search Console の読み取りに必要な認証スコープ
SEARCH_CONSOLE_SCOPES = ["https://www.googleapis.com/auth/webmasters.readonly"]

# --- Search Console 連携ツール ---
@mcp.tool()
def get_search_keywords(site_url: str, days: int = 30) -> str:
    """Search Console から検索キーワードと掲載順位を取得します。"""
    # 鍵ファイルを読み込む際に、必ずスコープを明示して認証する
    credentials = service_account.Credentials.from_service_account_file(
        os.getenv("GOOGLE_APPLICATION_CREDENTIALS"),
        scopes=SEARCH_CONSOLE_SCOPES
    )
    service = build("searchconsole", "v1", credentials=credentials)

    # Search Console の日付は YYYY-MM-DD 形式で渡す必要がある
    end_date = date.today()
    start_date = end_date - timedelta(days=days)

    request = {
        "startDate": start_date.isoformat(),
        "endDate": end_date.isoformat(),
        "dimensions": ["query", "page"],
        "rowLimit": 25
    }

    response = service.searchanalytics().query(siteUrl=site_url, body=request).execute()
    rows = response.get("rows", [])
    if not rows:
        return "データが見つかりませんでした。サイトURLの指定形式と、データ反映の待ち時間を確認してください。"

    output = []
    for row in rows:
        query, page = row["keys"][0], row["keys"][1]
        output.append(
            f"キーワード: {query} / ページ: {page} / 表示: {row['impressions']}回 / "
            f"クリック: {row['clicks']}回 / 平均掲載順位: {round(row['position'], 1)}位"
        )
    return "
".join(output)

# --- Google Analytics 4 (GA4) 連携ツール ---
@mcp.tool()
def get_ga4_page_views(property_id: str, days: int = 30) -> str:
    """GA4 からページ別のPV数とアクティブユーザー数を取得します。"""
    # 環境変数 GOOGLE_APPLICATION_CREDENTIALS のパスから自動で認証される
    client = BetaAnalyticsDataClient()

    request = RunReportRequest(
        property=f"properties/{property_id}",
        dimensions=[Dimension(name="pagePath")],
        metrics=[Metric(name="screenPageViews"), Metric(name="activeUsers")],
        date_ranges=[DateRange(start_date=f"{days}daysAgo", end_date="today")],
        limit=25
    )

    response = client.run_report(request=request)
    output = []
    for row in response.rows:
        page = row.dimension_values[0].value
        views = row.metric_values[0].value
        users = row.metric_values[1].value
        output.append(f"ページ: {page} / PV: {views} / ユーザー: {users}")

    return "
".join(output)

json
{
  "mcpServers": {
    "seo-analytics": {
      "command": "python3",
      "args": ["/絶対パス/analytics_mcp.py"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/絶対パス/credentials.json"
      }
    }
  }
}

サーチコンソールで検索露出が上位に入っているページの中で、GA4での実PV数が伸び悩んでいるボトルネックページをリストアップし、流入クエリに基づいた改善レポートを作成して