Web Analytics Skill
このスキルにより、エージェントはGoogleとBingからトラフィックデータを取得・分析し、深いSEOインサイトを提供できます。
環境準備
必要なスクリプトは、このSKILL.mdファイルからの相対パスであるscripts/ディレクトリにあります。
次の依存関係がインストールされていることを確認してください：
python3 -m pip install -r scripts/gsc-requirements.txt
必要な認証情報とその取得方法
このスキルを実行する前に、環境が設定されていることを確認してください。ユーザーが必要な認証情報を持っていない場合、エージェントは以下の手順で認証情報を取得するようユーザーに指示する必要があります。
1. Google OAuthクライアントシークレット（client_secret.json）
エージェントは、Google APIにアクセスするためにDesktop OAuth 2.0クライアントIDを必要とします。 ユーザー向け手順：
- Google Cloud Consoleにアクセスします。
- 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
- APIとサービス > ライブラリに移動し、Google Search Console APIとGoogle Analytics Data APIを有効にします。
- APIとサービス > OAuth同意画面に移動し、設定します（ユーザータイプを「外部」に設定し、自分のメールアドレスをテストユーザーとして追加できます）。
- APIとサービス > 認証情報に移動します。認証情報を作成 > OAuthクライアントIDをクリックします。
- アプリケーションタイプとしてデスクトップアプリを選択します。
- 「作成」をクリックし、JSONファイルをダウンロードします。ファイル名を
client_secret.jsonに変更し、このスキルのscripts/ディレクトリに配置します。
2. Google OAuthトークン（token.json、google_analytics_token.json）
これらはスクリプトによって自動的に生成されます。
- エージェント指示： スクリプトの出力に「ブラウザを開いて認証しています」と表示された場合、ユーザーにコンピューターで新しく開かれたブラウザウィンドウを確認し、Google OAuthログインを完了するよう伝えてください。ログインが成功すると、スクリプトが自動的にトークンをローカルに保存します。
3. Bing APIキー
ユーザー向け手順：
- Bing Webmaster Toolsにアクセスします。
- 確認済みのウェブサイトを選択します。
- 右上の設定歯車アイコンをクリックします。
- APIアクセス > APIキーに移動します。
- APIキーを生成をクリックするか（既存のキーをコピーします）。
.envファイルにBING_API_KEY=your_key_hereとして貼り付けます。
実行手順
1. Google Search Console（GSC）データの収集
GSC分析スクリプトを実行して、クリック数、インプレッション数、CTR、平均掲載順位を取得します：
cd scripts && python3 analyze_gsc.py
2. Google Analytics 4（GA4）データの収集
GA4スクリプトを実行して、ユーザーセッション、トラフィックソース、ページビューを分析します：
cd scripts && python3 ga4_both.py
3. Bing Webmaster Toolsデータの収集
Bingスクリプトを実行して、Bingの検索パフォーマンスをGoogleと比較します：
export BING_API_KEY=$(grep BING_API_KEY ../../.env | cut -d '=' -f2)
cd scripts && python3 bing_webmaster.py
4. インサイトの統合
結合された出力を分析し、次の項目を報告します：
- トレンド分析：14日間のビューに基づいて、全体のトラフィックは増加していますか、それとも減少していますか？
- プラットフォーム比率：Bingのトラフィックの割合はGoogleと比較してどのくらいですか？
- キーワードとページの機会：インプレッション数が高いがCTRが低いキーワード、またはBingでは良好にパフォーマンスしているがGoogleではしていないページを強調表示します。
最終的なサマリーをクリーンなMarkdownでユーザーに提供します。