Google アナリティクスの AI エージェントのスキル

Google アナリティクスのレポートとプロパティ管理の統合を、より高い精度とより低いトークン オーバーヘッドで構築するには、AI コーディング エージェントに Google アナリティクス AI エージェントのスキルを装備します。Google Analytics Data API と Google Analytics Admin API を使用して開発を行うデベロッパー向けに設計された Google アナリティクス AI エージェント スキルは、手順、ワークフロー、クライアント ライブラリ リファレンスを含む、ポータブルで自己完結型のモジュールです。

これらの AI エージェント スキルは、オープン Agent Skills 標準をサポートする AI コーディング エージェント（Google Antigravity、Claude Code、Codex、Cursor など）と連携します。公開されているスキルの一覧については、利用可能なスキルをご覧ください。

始める前に

Google アナリティクス AI エージェント スキルをインストールして実行する前に、次の前提条件を満たしてください。

  • Google Antigravity、Claude Code、Codex、Cursor など、オープン Agent Skills 標準をサポートする AI コーディング エージェントをインストールします。
  • Node.js をインストールします。これには、コマンドラインからスキルをインストールして更新するための npx コマンドが含まれています。
  • API ワークフローの実行時に Google アナリティクスのプロパティにアクセスできる プロジェクトを作成または選択します。

始める

開発環境に Google アナリティクス AI エージェント スキルをインストール、更新、呼び出します。

Google アナリティクス AI エージェント スキルをインストールする

npx コマンドを使用して、プロジェクト ディレクトリに Google アナリティクス スキルスイートをインストールするか、エディタを直接構成します。

Antigravity

プロジェクト ディレクトリで次のコマンドを実行します。

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

プロジェクト ディレクトリで次のコマンドを実行します。

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

プロジェクト ディレクトリで次のコマンドを実行します。

npx skills add google/skills/skills/analytics --agent=codex

Cursor

カスタムルールのエディタ設定にスキル リポジトリの URL（https://github.com/google/skills）を追加します。手順については、GitHub からスキルをインストールする Cursor のドキュメントをご覧ください。

または、npx コマンドを使用して、プロジェクト ディレクトリにスキルをインストールします。

npx skills add google/skills/skills/analytics --agent=cursor

他のエージェント

オープン Agent Skills 標準をサポートする他の AI コーディング エージェントの場合は、プロジェクト ディレクトリで次のコマンドを実行します。

npx skills add google/skills/skills/analytics

Google アナリティクスの AI エージェントのスキルを更新する

次のコマンドを実行して、利用可能なアップデートをダウンロードし、古いスキルをクリーンアップします。

npx skills update --all

Google アナリティクスの AI エージェント スキルを使用する

AI コーディング エージェントは、スキルの説明がプロンプトと一致すると判断すると、スキルを自動的に読み込みます。グローバルにインストールされたスキルは、リクエストに Google アナリティクスのタスクが含まれていない限り、関連性のないプロジェクトでは休止状態のままになります。

サポートされている AI コーディング エージェントでスキルを手動で呼び出すには、チャット入力に / 文字を入力し、名前でスキルを選択します。

スキルのコア コンポーネント

各 Google アナリティクス AI エージェント スキルは、AI コーディング エージェントに次のコンポーネントを提供します。

  • 専門的な手順: gcloud CLI を使用して Google アナリティクス API を有効にする、アプリケーションのデフォルト認証情報（ADC）を構成する、runReport クエリを作成する、フィールドの互換性を確認する手順を説明します。
  • ベスト プラクティス: 推奨される API バージョンの選択（一般的な安定性のための v1beta エンドポイントと、早期アクセスの Admin API 機能のための v1alpha エンドポイント）、厳密に型指定されたリクエストの作成、スキーマ検証ワークフロー。
  • リファレンス ドキュメント: 各スキルの references/ ディレクトリにある、Python、Java、Node.js、PHP、Go、.NET、Ruby の言語固有のクライアント ライブラリ インストール ガイドとコードサンプル。

AI エージェント スキルのメリット

AI エージェント スキルを使用すると、大規模なドキュメント セットをすべての会話に読み込むことなく、オンデマンドで Google アナリティクスの専門知識を AI コーディング エージェントに拡張できます。

トークン費用の削減

完全な API リファレンス ドキュメントを事前に読み込むと、コンテキスト トークンが消費され、セッション費用が増加します。AI エージェント スキルでは、段階的開示を使用してコンテキストの使用量を最小限に抑えます。

  • 起動時に、AI コーディング エージェントは各スキルの名前と簡単な説明のみを読み取り、スキルがプロンプトと一致するかどうかを確認します。
  • エージェントは、タスクで必要な場合にのみ、完全な SKILL.md 手順と、言語固有の参照ファイルをアクティブなコンテキスト ウィンドウに読み込みます。

AI ガイド付きの実装

目標を自然言語で記述すると、インストールされたスキルが、次のような Google アナリティクスの実装タスクを AI コーディング エージェントに指示します。

  • プロジェクトで Google Analytics Data API を有効にし、city ディメンションと date ディメンションで activeUsers 指標と sessions 指標をクエリする Python スクリプトを作成する。
  • checkCompatibility メソッドを使用して、itemName ディメンションが Google アナリティクスのプロパティの activeUsers 指標と totalRevenue 指標に対応しているかどうかを確認します。
  • Google Analytics Admin API を使用して、アクセス可能なすべての Google アナリティクス アカウントの概要と子プロパティを Node.js で一覧表示します。
  • Google アナリティクスのプロパティのカスタム ディメンション、データ ストリーム、Measurement Protocol のシークレットを構成する。

Google アナリティクス MCP サーバーとともにスキルを使用する

Google アナリティクス AI エージェントのスキルは、Google アナリティクス Model Context Protocol（MCP）サーバーを補完します。

  • Google アナリティクス MCP サーバー: AI コーディング エージェントをライブの Google アナリティクスのプロパティに直接接続します。これにより、エージェントはアカウントの概要、プロパティの詳細、カスタム ディメンション、カスタム指標、ライブレポートを検査できます。
  • Google アナリティクス AI エージェントのスキル: API の有効化、ADC 認証の構成、フィールドの互換性の確認、アプリケーション コードの作成時に AI コーディング エージェントをガイドする、トークン効率の高い手順とクライアント ライブラリ リファレンスを提供します。

利用可能なスキル

Google は、google/skills リポジトリで次の Google アナリティクス AI エージェント スキルを管理しています。

スキル 説明
google-analytics-data-api-basics gcloud CLI で Google Analytics Data API（analyticsdata.googleapis.com）を有効にし、analytics.readonly OAuth 2.0 スコープで ADC を構成して、公式の v1beta クライアント ライブラリ（Python、Java、PHP、Node.js、Go、.NET、Ruby）をインストールします。runReport クエリの作成と、getMetadata メソッドと checkCompatibility メソッドを使用したフィールドの互換性の確認について、エージェントに指示します。
google-analytics-admin-api-basics gcloud CLI で Google Analytics Admin API（analyticsadmin.googleapis.com）を有効にし、analytics.readonly と analytics.edit の OAuth 2.0 スコープで ADC を構成し、公式の v1beta と v1alpha のクライアント ライブラリ（Python、Java、PHP、Node.js、Go、.NET、Ruby）をインストールします。アカウントの概要の一覧表示、プロパティ、データ ストリーム、カスタム ディメンション、カスタム指標、キーイベント、Measurement Protocol のシークレット、サービス間のリンクの管理について、エージェントをガイドします。

次のステップ