mcpField
P
pp-google-analytics

pp-google-analytics

github.com/mvanhornマーケティング・グロース2.1k148 回インストール今日更新
リポジトリ

pp-google-analytics について

pp-google-analyticsは、Agentによるgoogle-analytics-pp-cliの利用を案内するスキルです。GA4のレポート、比較、アクセス診断に対応し、Search Consoleの作業とは分けて扱います。

主な機能

  1. 01GA4プロパティレポート
  2. 02獲得と収益の集計
  3. 03ファネルと期間の比較
  4. 04異常とアクセスの診断

活用シーン

  1. 01チャネル実績の確認
  2. 02期間ごとのセッション数や収益の比較
  3. 03プロパティアクセスエラーの調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-google-analytics

インストール後、Claude Code で/pp-google-analyticsを入力して読み込まれたか確認します。

詳細

pp-google-analytics

前提条件：CLI をインストールする

このスキルは google-analytics-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。 インストールされていない場合は、先にインストールしてください。

  1. Printing Press インストーラーを使って、ユーザーの bin ディレクトリにインストールします。 
    npx -y @mvanhorn/printing-press-library install google-analytics --cli-only --bin-dir ~/.local/bin
  2. 次のコマンドで確認します：google-analytics-pp-cli --version
  3. このスキルを実行するエージェント／ランタイムの $PATH に ~/.local/bin が含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールしてください（Go 1.26.6 以降が必要です）。この方法では $GOPATH/bin（デフォルトは $HOME/go/bin）にインストールされるため、代わりにそのディレクトリを $PATH に追加してください。

go install github.com/mvanhorn/printing-press-library/library/marketing/google-analytics/cmd/google-analytics-pp-cli@latest

インストール後に --version を実行して「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が完了するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場面

エージェントが GA4 の最新のプロパティデータ、集客／収益の概要、E コマースの診断、ファネル、期間比較、異常スキャン、プロパティアクセスの診断を必要とする場合に、この CLI を使用してください。Search Console には google-search-console-pp-cli を使用してください。

GA4 のみを対象とする分析には google-analytics-pp-cli を使用してください。Search Console は google-search-console-pp-cli が対象です。新しい作業では、GSC／GA4 を統合した旧 CLI を使用しないでください。

認証とプロパティの選択

  • サービスアカウントキー：--credentials を指定するか、GOOGLE_APPLICATION_CREDENTIALS を設定します。
  • スコープ：https://www.googleapis.com/auth/analytics.readonly
  • プロパティ：--property を指定するか、GA4_PROPERTY_ID を設定します。
  • 複数プロパティのヘルスチェック：health --properties $GA4_PROPERTY_IDS --agent を実行するか、GA4_PROPERTY_IDS を設定します。

注意すべき点：Google Cloud API へのアクセス権限は、GA4 プロパティへのアクセス権限とは異なります。サービスアカウントには、GA4 プロパティ内で閲覧者アクセス権を付与する必要があります。health でトークン／管理者の状態が OK と表示される一方、プロパティのチェックが 403／404 になる場合は、認証情報を変更するのではなく、GA4 プロパティのアクセス権を修正してください。

エージェント向けのおすすめコマンド

google-analytics-pp-cli agent-context --agent
google-analytics-pp-cli health --properties $GA4_PROPERTY_IDS --agent
google-analytics-pp-cli channels --property "$GA4_PROPERTY_ID" --start 28daysAgo --end yesterday --agent
google-analytics-pp-cli sources --property "$GA4_PROPERTY_ID" --agent
google-analytics-pp-cli top-pages --property "$GA4_PROPERTY_ID" --agent
google-analytics-pp-cli compare --property "$GA4_PROPERTY_ID" --metric sessions,totalRevenue --period wow --agent
google-analytics-pp-cli whats-changed --property "$GA4_PROPERTY_ID" --agent
google-analytics-pp-cli revenue --property "$GA4_PROPERTY_ID" --by channel --agent
google-analytics-pp-cli funnel --property "$GA4_PROPERTY_ID" --steps view_item,add_to_cart,begin_checkout,purchase --agent

低レベルのラッパー

低レベルの代替手段として、report、pivot、batch、realtime、metadata、compatibility、properties、property、streams を利用できます。ビジネス上の質問に答える際は、新しいコマンドを優先してください。

コメント

Markdown 対応