【第4回】Claude Code×GitHub Actionsで自動実行｜GA4レポート作成

name: GA4 Report Generator

on:
  schedule:
    – cron: ‘0 0 * * 1’   # 週次: 毎週月曜 9:00 JST
    – cron: ‘0 0 1 * *’   # 月次: 毎月1日 9:00 JST
  workflow_dispatch:
    inputs:
      report_type:
        description: ‘生成するレポートの種類’
        required: true
        type: choice
        options:
          – weekly
          – monthly

jobs:
  weekly-report:
    name: 週次レポート生成
    if: github.event.schedule == ‘0 0 * * 1’ || inputs.report_type == ‘weekly’
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      – uses: actions/checkout@v4

      – name: 認証情報を設定
        run: echo ‘${{ secrets.GOOGLE_CREDENTIALS }}’ > /tmp/ga4-credentials.json

      – name: pipx / analytics-mcp をインストール
        run: |
          python -m pip install –user pipx
          python -m pipx ensurepath
          pipx install analytics-mcp

      – name: Claude Code をインストール
        run: npm install -g @anthropic-ai/claude-code

      – name: 週次レポートを生成
        env:
          CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          GOOGLE_APPLICATION_CREDENTIALS: /tmp/ga4-credentials.json
        run: |
          claude -p “
          あなたはGA4レポート自動生成エージェントです。CLAUDE.mdの指示に従い、アルル制作所（GA4プロパティID: xxxxxxxxx）の週次レポートを作成してください。

          ## 作業手順
          1. 今日の日付を確認し（月曜実行）、前週の集計期間（月曜〜日曜）と前々週の集計期間を計算する
          2. GA4 MCPツールを使って以下のデータを取得:
             – 指標: sessions, activeUsers, engagementRate
             – ディメンション: pagePath（上位10件）
             – 前週・前々週の両期間分
          3. templates/report_weekly.html を読み込み、全プレースホルダーを実データに置き換える
          4. ISO週番号を計算し、reports/アルル制作所/report_YYYYWNN.html として保存（NNは2桁週番号）

          ## 判定ルール
          – セッション・ユーザー増加 → badge-green / up、減少 → badge-red / down
          – エンゲージメント率 ±3pt以内 → badge-orange、+3pt超 → badge-green、-3pt超 → badge-red

          ## 注意
          – CLAUDE.mdのプレースホルダー仕様・デザイン仕様に厳密に従うこと
          – 数値はカンマ区切り（例: 1,234）、エンゲージメント率はパーセント表示（例: 52.3%）
          – git操作は不要。ファイルの保存のみ行うこと
          ” –allowedTools “Bash,Read,Write,Edit,Glob,Grep,mcp__ga4__run_report,mcp__ga4__get_account_summaries,mcp__ga4__get_property_details”

      – name: コミット & プッシュ
        run: |
          git config user.name “github-actions[bot]”
          git config user.email “github-actions[bot]@users.noreply.github.com”
          git add reports/
          git diff –cached –quiet || git commit -m “Add 週次レポート $(date -d ‘last monday’ ‘+%GW%V’) アルル制作所”
          git push

  monthly-report:
    name: 月次レポート生成
    if: github.event.schedule == ‘0 0 1 * *’ || inputs.report_type == ‘monthly’
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      – uses: actions/checkout@v4

      – name: 認証情報を設定
        run: echo ‘${{ secrets.GOOGLE_CREDENTIALS }}’ > /tmp/ga4-credentials.json

      – name: pipx / analytics-mcp をインストール
        run: |
          python -m pip install –user pipx
          python -m pipx ensurepath
          pipx install analytics-mcp

      – name: Claude Code をインストール
        run: npm install -g @anthropic-ai/claude-code

      – name: 月次レポートを生成
        env:
          CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          GOOGLE_APPLICATION_CREDENTIALS: /tmp/ga4-credentials.json
        run: |
          claude -p “
          あなたはGA4レポート自動生成エージェントです。CLAUDE.mdの指示に従い、アルル制作所（GA4プロパティID: 304900846）の月次レポートを作成してください。

          ## 作業手順
          1. 今日の日付を確認し、前月の集計期間（1日〜末日）と前々月の集計期間を計算する
          2. GA4 MCPツールを使って以下のデータを取得:
             – 指標: sessions, activeUsers, engagementRate
             – ディメンション: pagePath（上位10件）
             – 前月・前々月の両期間分
          3. templates/report_monthly.html を読み込み、全プレースホルダーを実データに置き換える
          4. reports/アルル制作所/report_YYYYMM.html として保存（YYYYMMは前月の年月）

          ## 判定ルール
          – セッション・ユーザー増加 → badge-green / up、減少 → badge-red / down
          – エンゲージメント率 ±3pt以内 → badge-orange、+3pt超 → badge-green、-3pt超 → badge-red

          ## 注意
          – CLAUDE.mdのプレースホルダー仕様・デザイン仕様に厳密に従うこと
          – 数値はカンマ区切り（例: 1,234）、エンゲージメント率はパーセント表示（例: 52.3%）
          – git操作は不要。ファイルの保存のみ行うこと
          ” –allowedTools “Bash,Read,Write,Edit,Glob,Grep,mcp__ga4__run_report,mcp__ga4__get_account_summaries,mcp__ga4__get_property_details”

      – name: コミット & プッシュ
        run: |
          git config user.name “github-actions[bot]”
          git config user.email “github-actions[bot]@users.noreply.github.com”
          git add reports/
          git diff –cached –quiet || git commit -m “Add 月次レポート $(date -d ‘last month’ ‘+%Y%m’) アルル制作所”
          git push