GA4 MCP Server

cd ga4-mcp-server
npm install
npm run build

# Windows (winget)
winget install Google.CloudSDK

# または https://cloud.google.com/sdk/docs/install からダウンロード

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/analytics.readonly"

{
  "mcpServers": {
    "ga4": {
      "command": "node",
      "args": ["/path/to/ga4-mcp-server/dist/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789"
      }
    }
  }
}

{
  "mcpServers": {
    "ga4": {
      "command": "node",
      "args": ["/path/to/ga4-mcp-server/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
        "GA4_PROPERTY_ID": "123456789"
      }
    }
  }
}

「今日のPV数を教えて」
→ get_traffic_summary (period: "today")

「今リアルタイムで何人見てる？」
→ run_realtime_report

「過去7日間のアクセス数が多いページTOP10」
→ get_top_pages (period: "7days", limit: 10)

「どこからアクセスが来てる？」
→ get_traffic_sources (period: "7days", groupBy: "channel")

「先週と今週を比較して」
→ compare_periods (comparisonType: "previousPeriod", period: "7days")

「モバイルとPCの比率は？」
→ get_device_breakdown (period: "7days")

「何時頃にアクセスが多い？」
→ get_hourly_traffic (period: "7days")

「このページを見た人は次にどこに行く？」
→ get_user_journey (pagePath: "/product/123", direction: "next")

# 開発モード（ファイル変更を監視してリビルド）
npm run dev

# ビルド
npm run build

# 型チェック
npm run typecheck