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 日推出了全新的 GSC AI Performance Report (Search Engine Land 公告)，在一个统一界面中涵盖 AI Overviews 和 AI Mode。此技能可帮助你：(a) 了解品牌在新报告中的基准可见度，(b) 理解各项指标的取舍，以及 (c) 决定是否使用 Search Console 中的新退出选项开关。

真正新增的内容（2026 年 6 月 3 日）

指标 / 界面	状态
AI Overviews + AI Mode 合并展示次数	新增——两种界面共用一份报告
引用的网页（按查询组）	新增
国家/地区细分	新增
设备细分	新增
日期范围筛选	新增
点击数据	不包含（Google 明确排除——这是归因时的重要注意事项）
Search Console 中的退出选项开关	新增（无需再部署 robots.txt / meta 标签来专门排除 AI）
API 接口	尚未发布——仅限界面（最后检查于 2026 年 7 月；自动化前请重新查看 Search Console API 版本说明）
Discover 生成式界面	新增（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 对这一界面恰好存在盲点。其 AI Assistant 渠道不包括 Google 的 AI Overviews 和 AI Mode；GA4 会将这些访问计入自然搜索（参见下方映射和 /digital-marketing-pro:analytics-insights）。

诚实的衡量范围——现有与不存在的内容（截至 2026-10-04 已核实）

每份交付内容都应说明这些限制。空白单元格不代表数值为零，而是没有任何第一方工具会公布该指标。

问题	第一方答案	来源
Google 在 AI Overviews / AI Mode 中展示了我的网页多少次？	**有：**Search Console 生成式 AI 效果报告中的展示次数。你可以按 Pages、Countries、Dates、Devices 分组，并按搜索类型（文本 / 多模态）筛选。导出按钮会下载图表和表格	Search Console 帮助
哪些查询触发了这些 AI 展示？	**不存在。**该报告没有 Queries 维度	同上
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？	帮助页面未作说明；该页面仅介绍了界面及其导出按钮。自动化流程应使用 CSV 导出	同上
Copilot / Bing AI 引用？	**有，但使用的是另一款工具：**Bing Webmaster Tools AI Performance（引用、grounding 查询、引用份额、意图）。该工具不显示点击次数	/digital-marketing-pro:geo-monitor
ChatGPT / Claude / Perplexity 引用？	**不存在第一方报告。**仅有合成探测（/digital-marketing-pro:aeo-audit、/digital-marketing-pro:geo-monitor），并标注为探测结果	—

Google 的 AI 优化指南将此报告列为衡量生成式 AI 可见性的方式。指南还警告：“没有任何第三方工具能够访问我们的内部排名系统或 AI 系统。”

何时使用此技能

• 为新品牌设定 AI 可见性基线（首次采集 30 天的 AI Overview + AI Mode 展示数据）
• 将品牌 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 中针对司法管辖区的规则（欧盟市场——参见 skills/context-engine/eu-code-of-practice.md，了解《人工智能法案》第 50 条透明度相关背景）

编号输出约定

所有输出均写入 ${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 验证，并拥有品牌域名的访问权限。自 31 Aug 2026 起，全球所有网站均可使用此报告。如果找不到报告，请检查网站是否被排除在 Search 生成式 AI 功能之外，或 AI 功能展示次数是否过少。
2. 找到报告 — Search Console → 左侧导航栏 → 效果 → 切换到 搜索结果 标签页 → 找到新的 AI Overviews & AI Mode 标签页（推出期间，标签页标题可能略有不同；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 导出 → 按日期命名的归档文件夹），以便在未来 6–12 个月 AI 搜索普及率增长时逐渐形成趋势线。

输出

一份结构化的 GSC AI 效果简报，包含：

• 基准指标 — 当前周期的展示次数、页面、国家/地区分布、设备分布
• 趋势分析 — 周期环比变化（如有历史数据）
• 对照表 — GSC 实际数据与 aeo-audit 合成结果的比较，并附差距说明
• 是否退出的建议 — 明确说明选择加入或退出，并根据行业特征和品牌背景阐述理由
• 优化交接 — 列出品牌引用不足且影响较大的主题（转至 aeo-geo）
• 跟踪频率 — 建议的每月导出计划及归档路径

注意事项和已知限制（2026 年 6 月）

1. 没有点击数据、没有点击率、没有查询。 报告仅显示展示次数，并按页面／国家／日期／设备维度细分。
   • GA4 的 AI Assistant 渠道（规则：medium 完全匹配 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 展示次数直接一一对比。 AI Overviews 的呈现方式不同——其中的“展示”意味着你的页面被用作依据来源，这比出现在 10 个蓝色链接的搜索结果中门槛更高。

使用的 Agent

• 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 引用内容的欧盟《人工智能法案》第 50 条透明度背景
• scripts/gsc-ai-performance.py——辅助脚本（Google 发布 API 前的占位脚本；目前读取导出的 CSV）