gsc-ai-performance

/digital-marketing-pro:gsc-ai-performance

スクリプトの場所。 ホストで ${CLAUDE_PLUGIN_ROOT} が設定されていない場合、スクリプトはこのプラグインの scripts/ フォルダー（skills/ の隣）にあります。Python 3.10 以降で実行してください。python を使用するか、python が見つからない場合は python3 を使用します（macOS、多くの Linux システム）。

目的

Google は 2026 年 6 月 3 日、AI Overviews と AI Mode の両方を単一の画面で扱う、新しい GSC AI Performance Report を公開しました（Search Engine Land の発表）。このスキルは、（a）新しいレポートにおけるブランドの可視性の基準値を把握し、（b）指標間のトレードオフを理解し、（c）SC 内の新しいオプトアウト切り替えを使用するかどうかを判断するのに役立ちます。

本当に新しい機能（2026 年 6 月 3 日）

指標／画面	状況
AI Overviews + AI Mode の合算インプレッション数	新機能 — 両方の画面を対象とする単一のレポート
引用されたページ（クエリグループごと）	新機能
国別の内訳	新機能
デバイス別の内訳	新機能
期間フィルタリング	新機能
クリックデータ	含まれません（Google が明示的に除外 — アトリビューションに関する重要な注意点）
Search Console のオプトアウト切り替え	新機能（AI のみに対する除外に robots.txt やメタタグを追加する必要がなくなります）
API の提供状況	未公開 — UI のみ（最終確認：2026 年 7 月。自動化する前に Search Console API のリリースノートを再確認してください）
Discover の生成 AI サーフェス	新機能（2026 年 6 月〜7 月） — レポートファミリーが Discover の生成 AI 機能も対象とするようになりました（Google の発表）
データの提供状況	2026 年 5 月 18 日まで遡ってデータが補完されました。2026 年 7 月に広くアクセスできるようになり、AI コントロールに関する詳細なヘルプドキュメントも公開されました
地域別の展開	英国が先行し、その後グローバルに展開（出典）
マルチモーダルフィルタ	新機能（2026 年 9 月） — multimodal 検索タイプフィルタ（Lens、Circle to Search、画像アップロード）が検索パフォーマンスレポートと生成 AI レポートの両方に表示されます。クエリのディメンションはなく、これらのインプレッションは新たにカウントされます（Google Search Central）

重要な解釈上の注意： このレポートが示すのは、ユーザーがページにクリックして移動したタイミングではなく、AI Overviews／AI Mode でページが表示されたタイミングです。

クリックデータがないため、AI トラフィックに対するその後のアトリビューションはすべてアナリティクスから得る必要があります。また、GA4 にはまさにこのサーフェスに関する盲点があります。GA4 の AI Assistant チャネルには、Google の AI Overviews と AI Mode は含まれません。GA4 ではこれらの訪問が Organic Search としてカウントされます（下のマップと /digital-marketing-pro:analytics-insights を参照）。

正直な計測マップ — 何があり、何がないか（2026-10-04 確認）

すべての成果物で、これらの制限を明記してください。空欄はゼロを意味するのではなく、ファーストパーティのツールが公開していない指標を意味します。

質問	ファーストパーティの回答	出典
Google は AI Overviews / AI Mode でページをどのくらい表示しましたか？	はい： Search Console の生成 AI パフォーマンス レポートでインプレッションを確認できます。ページ、国、日付、デバイスでグループ化し、検索タイプ（テキスト／マルチモーダル）でフィルタリングできます。エクスポートボタンでグラフと表をダウンロードできます	Search Console のヘルプ
これらの AI インプレッションを発生させたクエリは何ですか？	ありません。 このレポートにはクエリのディメンションがありません	同上
AI Overviews / AI Mode からのクリック数とCTRはどのくらいですか？	Search Console にはありません。レポートに表示されるのはインプレッションのみです	同上；Google Search Central ブログ（2026 年 6 月 3 日）
GA4 で AI Overviews / AI Mode からの訪問を分けて確認できますか？	ドキュメントに記載された方法はありません。 GA4 の Organic Search チャネルには「Google の AI Overviews と AI Mode」が含まれ、AI Assistant チャネルには含まれません。Google のチャネルページには、オーガニック検索からこれらを分けるディメンションの記載がありません	GA4 のデフォルト チャネル グループ
レポートを閲覧できるのは誰ですか？	Google：「2026 年 8 月 31 日時点で、これらのインサイトは世界中のすべてのウェブサイトに公開されています。」プロパティに表示されない場合、そのサイトの AI 機能でのインプレッションが少なすぎるか、Search の生成 AI 機能の対象外である可能性があります	Search Console のヘルプ
API はありますか？	ヘルプページには記載されていません。同ページに説明があるのは UI とエクスポートボタンのみです。自動化には CSV エクスポートを使用してください	同上
Copilot / Bing AI の引用はどうですか？	はい。ただし別のツールです： Bing Webmaster Tools の AI Performance（引用、グラウンディング クエリ、引用シェア、インテント）。クリック数は表示されません	/digital-marketing-pro:geo-monitor
ChatGPT / Claude / Perplexity の引用はどうですか？	ファーストパーティのレポートはありません。 合成プローブ（/digital-marketing-pro:aeo-audit、/digital-marketing-pro:geo-monitor）のみで、プローブとして明記します	—

Google の AI 最適化ガイドでは、生成 AI での可視性を計測する方法としてこのレポートを案内しています。また、「サードパーティのツールが当社の内部ランキングや AI システムにアクセスすることはできません」と警告しています。

このスキルを使用するタイミング

• 新しいブランドの AI での可視性のベースラインを設定する（AI Overview + AI Mode のインプレッションを最初の 30 日間に取得）
• ブランドの AI での可視性を aeo-audit の合成結果と比較する — GSC レポートには実際のインプレッションが表示され、aeo-audit にはプローブクエリの結果が表示されます
• ブランドで SC 内の AI オプトアウト切り替えを有効にするか判断する（規制対象業界、ブランドセーフティ上の懸念、ペイウォール／ログインが必要なコンテンツ）
• 四半期ごとのビジネスレビューの根拠資料 — Google の信頼できるデータを使って「AI 検索のインプレッションが X% 増加」と報告する

ブランドのコンテキスト（自動適用）

1. ~/.claude-marketing/brands/_active-brand.json を読み取り、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます
2. ブランドが存在しない場合：「先にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねます — またはデフォルト設定で続行します
3. skills/context-engine/industry-profiles.md の業界固有のガイダンスを適用します（YMYL 業界では、E-E-A-T 監査が完了するまでオプトアウトをオンにする場合があります）
4. skills/context-engine/compliance-rules.md で管轄区域固有のルールを確認します（EU 市場 — 第 50 条の透明性に関する情報は skills/context-engine/eu-code-of-practice.md を参照）

番号付き出力の規約

すべての出力は ${CLAUDE_PLUGIN_DATA}/{brand}/seo/gsc-ai-performance/{YYYY-MM-DD}/ に保存します：

00-input.md                  brand domain, GSC access status, UK-cohort flag, date range
01-access-check.md           verification result; if no access, instructions for adding the user
02-export.csv                raw CSV export from GSC (preserved for reproducibility)
03-script-output.json        gsc-ai-performance.py parsed output (impressions, pages, countries, devices)
04-reconciliation.md         vs aeo-audit synthetic probe results — gap analysis
05-opt-out-decision.md       y/n on the in-SC opt-out toggle, with rationale
06-quality-scorecard.md      the gates below
PLAN.md                      single-page summary with tracking cadence

品質スコアカード

ゲート	確認内容
gsc_access_verified	ユーザーがブランドドメインの Search Console の所有権確認を完了していること
export_completeness	CSV に 1 日以上のデータと、最低限インプレッション列が含まれていること
cohort_documented	00-input.md にプロパティでレポートを確認できるかどうかが記載されていること。確認できない場合は、記録されている該当理由を記載します。AI 機能のインプレッションが少なすぎる、またはサイトが Search の生成 AI 機能から除外されている
reconciliation_done	04-reconciliation.md で、ブランドの最新の aeo-audit と照合していること

世界規模での展開（2026 年 8 月 31 日）後もプロパティでレポートを確認できない場合、ゲートの枠組みは引き続き適用されますが、export_completeness は fail になります。理由を記録してください。これは回帰ではなく、調査結果です。

チェーンの引き継ぎ

• 上流： プロパティの確認には /digital-marketing-pro:brand-setup
• 下流：
  • /digital-marketing-pro:aeo-geo — 表示されている（または表示されていない）内容に基づく最適化
  • /digital-marketing-pro:seo-drift — エクスポートした CSV を使用した月次追跡
  • /digital-marketing-pro:analytics-insights — GA4 AI Assistant のチャネルアトリビューションでクリック側のギャップを解消

プロセス

1. アクセス確認 — ユーザーがブランドのドメインについて Google Search Console の確認済みアクセス権を持っていることを確認します。このレポートは2026年8月31日以降、世界中のすべてのウェブサイトで利用可能です。見つからない場合は、サイトが検索の生成 AI 機能から除外されていないか、または AI 機能でのインプレッションが少なすぎないかを確認します。
2. レポートの場所を確認 — Search Console → 左側のナビゲーション → パフォーマンス → タブを検索結果に切り替え → 新しいAI による概要と AI モードタブを探します（段階的な公開中はタブ名が多少異なる場合があります。テスト中の Google の仮称は「Search Generative AI」でした）。タブが公開される前の段階では、既存のパフォーマンス レポートに AI 機能フィルターを適用してデータを確認できる場合もあります。
3. ベースラインをエクスポート — 期間を「過去28日間」（または公開以降に利用可能な最大期間）に設定し、Search Console のエクスポートボタンから CSV／Sheets にエクスポートします。インプレッション、ページ、国別の割合、デバイス別の割合を記録します。このレポートにはクエリのディメンションがありません（2026-10-04に確認済み）。そのため、クエリ一覧を提供できると約束しないでください。メインのパフォーマンス レポートのクエリは、別個の AI 固有ではないデータとしてのみ使用し、その旨を明記します。その後、ヘルパースクリプトで解析してアーカイブします。

   python "${CLAUDE_PLUGIN_ROOT}/scripts/gsc-ai-performance.py" \
       --brand {slug} \
       --csv "${CLAUDE_PLUGIN_DATA}/{brand}/seo/gsc-ai-performance/{date}/02-export.csv" \
       --format json \
       --archive
   

   実際に使用できるフラグは --brand（必須）、--csv（GSC エクスポートのパス）、--api（ベストエフォート。Google は AI レポートの API をまだ公開していません）、--site、--format text|json、--archive のみです。summary サブコマンドはありません。このスクリプトは CSV を読み取り、解析済みの指標を出力します。
4. aeo-audit と照合 — /digital-marketing-pro:aeo-audit の合成クエリは、AI エンジンが何を表示する可能性があるかをテストします。GSC レポートは、実際に何が表示されたかを示します。どちらの方向であれ、大きな差があれば兆候です。
   • GSC の表示が aeo-audit の結果を大幅に上回る → テスト対象のクエリセットが狭すぎます。範囲を広げてください
   • 合成結果で aeo-audit がブランドを見つけた一方、GSC のインプレッションが少ない → そのトピックのクエリ数が少ないため、AEO の取り組みを検索ボリュームの多いトピックに振り向けてください
5. オプトアウトの判断 — 次のいずれかに該当する場合は、SC 内のオプトアウト切り替えの利用を検討します。
   • 業界に YMYL／規制上のリスクがあり、ブランドの E-E-A-T がまだ十分に監査されていない
   • ブランドのコンテンツが有料壁の内側、またはログイン必須になっている（コンテンツの一部が AI に表示されると、コンバージョンファネルに悪影響を及ぼす可能性があります）
   • ブランドが積極的な評判管理の対象になっている — AI の回答に表示されると、AI モデルが取り込んだ感情が増幅されます
   • 編集チームが、AI による統合ではなく、まずブランド自身のプロパティを通じて修正内容を公開したい
6. 最適化の推奨事項を実行 — オプトアウトしないブランドは、最適化プレイブック（エンティティの一貫性、引用に適したスニペット、ナレッジグラフとの整合性）を確認するため、/digital-marketing-pro:aeo-geo に案内します。
7. 月次トラッキングを設定 — 定期的な gsc-ai-performance ベースライン（CSV エクスポート → 日付付きのアーカイブフォルダー）をスケジュールし、AI 検索の普及が進む今後6～12か月の推移を把握できるようにします。

出力

次の内容を含む、構成化された GSC AI パフォーマンス概要を作成します。

• ベースライン指標 — 現在の期間のインプレッション、ページ、国別の割合、デバイス別の割合
• トレンド分析 — 期間ごとの変化（過去のデータがある場合）
• 照合表 — GSC の実績と aeo-audit の合成結果、および差異に関する注記
• オプトアウトの推奨 — 業界プロファイルとブランドの状況に基づく根拠を添えた、オプトイン／オプトアウトの明確な判断
• 最適化の引き継ぎ — ブランドの引用が不足している、影響の大きいトピックの一覧（aeo-geo に案内）
• トラッキング頻度 — 推奨する月次エクスポートのスケジュールとアーカイブ先

注意事項と既知の制限（2026 年 6 月）

1. クリックデータ、CTR、クエリはありません。 レポートに表示されるのは、ページ／国／日付／デバイス別のディメンションを持つインプレッションのみです。
   • GA4 の AI Assistant チャネル（ルール：メディアが ai-assistant と完全一致）は、ChatGPT、Gemini、Deepseek、Copilot、Grok などのアシスタントからの参照を対象とします。
   • Google のチャネル定義によると（2026-10-04 に確認）、Google の AI Overviews と AI Mode は対象外で、これらは オーガニック検索 に分類されます。
   • したがって、AI Overviews または AI Mode からのクリックを報告するファーストパーティツールはありません。数値を推測せず、その旨を明確に伝えてください。出典：GA4 のデフォルト チャネル グループ。
2. 公開時点では UI のみです。 パブリック API はありません。Google が Search Console Search Analytics API（searchanalytics.query）で AI レポートを公開するまで、自動化は待ってください。現時点で自動化するには、CSV のエクスポートと手動アップロードが必要です。
3. 全世界で展開済みです。 レポートは英国から先行して開始されました。Google のヘルプページには現在、「2026 年 8 月 31 日時点で、これらの分析情報を世界中のすべてのウェブサイトに展開しました」と記載されています（2026-10-04 に確認）。後続の前月比比較が実際の基準値から始まるよう、初めてデータを確認した日付を記録してください。
4. 展開中にタブの配置が変わる可能性があります。 Google は最初の 30～60 日間に UI を頻繁に調整します。上記の手順 2 とタブの正確な場所が異なる場合は、[パフォーマンス] > [検索結果] エリア内で「AI」「生成」「AI Mode」「AI Overviews」のラベルを探してください。
5. 2026 年 9 月は、必ずしも成長を意味しない計測上の変更点です。 マルチモーダルのインプレッション（Lens、Circle to Search、画像のアップロード）は、2026 年 9 月に計測対象となりました。前月比の増加を報告する前に、マルチモーダルのフィルターを除外して比較を再実行してください。そうしないと、計測方法の変更が可視性の向上として表れてしまいます。
6. AI Overviews のインプレッションを、従来の SERP のインプレッションと単純に 1 対 1 で比較しないでください。 AI Overviews での表示のされ方は異なります。そこでの「インプレッション」は、ページが根拠情報のソースとして使用されたことを意味し、10 件の青いリンクの検索結果に表示されるよりも厳しい条件です。

使用したエージェント

• seo-specialist（主要）— 解釈と推奨事項の整理
• analytics-analyst — AI Assistant チャネルデータが利用可能な場合の GA4 との照合
• brand-guardian — ブランドセーフティまたはコンプライアンスが関係する場合のオプトアウト判断

関連項目

• /digital-marketing-pro:aeo-audit — 合成 AI エンジンのプローブ
• /digital-marketing-pro:aeo-geo — AI での可視性を高める最適化プレイブック
• /digital-marketing-pro:analytics-insights — GA4 の AI Assistant チャネルのアトリビューション
• skills/context-engine/eu-code-of-practice.md — AI が引用するコンテンツに関する EU Article 50 の透明性の文脈
• scripts/gsc-ai-performance.py — ヘルパースクリプト（Google が API を公開するまでプレースホルダー。現時点ではエクスポートした CSV を読み込みます）