关于 google-search-ai-optimization
面向开发者和内容团队的 Google Search 生成式 AI 优化技能,依据 Google 指引处理技术实现、内容规划与页面审查。按任务选择参考资料和审计工具,避免把 GEO 当作独立技巧路线。
主要功能
- 01按任务选择参考资料
- 02检查抓取、渲染与索引信号
- 03规划面向 AI 搜索的内容
- 04审查结构化数据与页面体验
- 05使用脚本检查页面信号
适用场景
- 01修复页面元数据或结构化数据
- 02规划适用于 AI Overviews 的内容
- 03检查页面是否可抓取和索引
- 04审查电商或本地商家旅程
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jpcaparas/ skills --skill google-search-ai-optimization安装后在 Claude Code 中输入/google-search-ai-optimization确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
AGENTS.mdmetadata.jsonREADME.mdskill-card.prompt.mdagents/.gitkeepassets/.gitkeepevals/evals.jsonreferences/content-and-entity-patterns.mdecommerce-local-agentic.mdgoogle-guidance.mdgotchas.mdREADME.mdtechnical-implementation.mdscripts/audit_page.pytest_skill.pyvalidate.pytemplates/implementation-brief-template.md详细介绍
google-search-ai-optimization
以 Google 官方指南为基准,构建并审核适用于 Google 搜索生成式 AI 功能的网页体验。
根据请求确定范围。修复标题、解答结构化数据问题或编辑内容,都不需要进行完整审核。只使用解决任务所需的参考资料和工具;常规布局、章节顺序和内容长度仍属于设计选择,并非 Google 的资格规则。
决策树
你要做什么?
-
在代码库中实施 SEO/GEO
- 如果更改需要涉及抓取、渲染、元数据或结构化数据的细节,请阅读
references/technical-implementation.md。 - 如果静态页面证据有帮助,请使用
scripts/audit_page.py。只有当目标页面预期会被编入索引时才添加--expect-indexable,绝不要对有意设置为noindex的页面使用此选项。
- 如果更改需要涉及抓取、渲染、元数据或结构化数据的细节,请阅读
-
为 AI Overviews、AI Mode 或查询扩展规划或编辑内容
- 内容选择请阅读
references/content-and-entity-patterns.md;需要了解政策依据时,请阅读references/google-guidance.md。
- 内容选择请阅读
-
处理电商、本地商家或 Agent 式用户旅程
- 请阅读
references/ecommerce-local-agentic.md
- 请阅读
-
调查误区、技巧、预览控制或有疑问的建议
- 请阅读
references/gotchas.md
- 请阅读
-
对整个代码库进行 SEO 全面审核并交接整改任务
- 优先使用 {{ skill:seo-analysis }},然后使用此技能处理 Google AI 搜索的专项实施选择。
快速参考
| 任务 | 操作 | 原因 |
|---|---|---|
| 让网页符合 Google AI 搜索展示资格 | 确保网页可编入索引、符合摘要展示资格、可抓取,并且对 Google 搜索用户有用 | Google 的生成式 AI 功能以搜索排名、检索和质量系统为基础 |
| 针对 Google 优化 GEO/AEO | 将其视为 SEO,而不是另一套独立技巧 | Google 的指南将 AEO/GEO 工作定位为优化搜索体验 |
| 实施技术基础 | 使用可抓取链接、规范 URL、正确的状态代码、渲染后的主要内容、站点地图和稳定的元数据 | 在内容优化发挥作用之前,Google 必须先发现、渲染、理解并选择该网页 |
| 改进 AI 答案所用内容 | 增添独特经验、原创事实、清晰结构、媒体内容,以及能满足用户需求的全面介绍 | 非同质化、以人为本的内容才是持久有效的信号 |
| 使用结构化数据 | 只添加能代表页面、与可见内容及 Google 功能文档相符的 JSON-LD | 结构化数据有助于获得富媒体搜索结果的展示资格,但并非生成式 AI 搜索的必需条件 |
| 谨慎控制摘要 | 仅在有意权衡利弊时使用 nosnippet、max-snippet、max-image-preview 和 data-nosnippet | 限制预览的控制项也可能限制内容在 AI Overviews 和 AI Mode 中的使用 |
| 忽略没有依据的技巧 | 不要为 Google 创建 llms.txt、仅供 AI 使用的标记、人为分块、虚假提及或大量查询变体页面 | Google 明确指出,这些做法对 Google 搜索没有必要或存在风险 |
| 支持浏览器 Agent | 使用语义化控件、标签、稳定布局、可见操作,以及清晰的无障碍树信号 | Agent 式体验会检查屏幕截图、HTML 和无障碍树 |
核心工作流
根据请求的更改执行相关步骤;只有在进行完整审计或制定实施计划时,才使用整个工作流。
- 确定页面类型和业务目标:信息、商业、产品、本地、文档、支持、账户或实用工具。
- 诊断面向搜索的内容是否符合条件时,检查状态码、可编入索引性、robots 指令、规范链接、可抓取链接、渲染后的主要内容以及摘要资格。保留有意设置的排除项。
- 必要时检查相关源抽象和渲染输出,以验证更改。共享布局、元数据、路由和 CMS 模板中的错误可能影响许多 URL。
- 优先改善用户体验:提供独特体验、非同质化信息、清晰的标题、有用的媒体、描述性链接,以及令人满意的后续步骤。
- 仅当结构化数据能准确表示页面上可见的内容,并且对应受支持的 Google 搜索功能或实体说明时,才添加结构化数据。
- 对于电商和本地网站,确保页面内容、结构化数据、Merchant Center 和 Google Business Profile 中的产品、商家及业务详情保持一致。
- 为 Agent 做好准备:将用户旅程作为机器可读界面进行测试,包括语义化 HTML、标签、稳定布局、可见操作,以及不会遮挡控件的不可见浮层。
- 记录权衡。如果页面使用了
noindex、nosnippet、仅依赖 JavaScript 的渲染或重复模板,请说明这是否出于有意设计。
不要捏造评价、使用欺骗性 schema,也不要向爬虫隐藏内容。更改 Search Console、Merchant Center 或 Business Profile 等外部属性前,必须先获得授权;站内代码任务并不代表获得了修改这些账户的许可。
预期交付内容
根据请求,提供答案、补丁或计划,并附上相关证据和验收检查。对于完整审计,可选用 templates/implementation-brief-template.md 进行整理,其中包括:
- 资格证据及其限制(当资格属于范围内事项时);
- 发现的问题和按顺序排列的修复措施;必要时使用表格;
- 内容和实体建议(当请求涉及内容工作时)。
仅当请求或证据涉及不受支持的策略时,才讨论这些策略。对于范围明确的回答,不要附加误区报告或无关计划。
阅读指南
| 需求 | 阅读内容 |
|---|---|
| 面向开发者的 Google AI 搜索官方指南提炼 | references/google-guidance.md |
| 爬取、渲染、索引、元数据、规范链接、robots、JS 和 schema 实现 | references/technical-implementation.md |
| 内容、实体、媒体、内部链接和查询扩展模式 | references/content-and-entity-patterns.md |
| 电商、本地商家、Merchant Center、Business Profile 和浏览器 Agent 用户体验 | references/ecommerce-local-agentic.md |
| 不受支持的策略、边缘情况和政策陷阱 | references/gotchas.md |
| 静态 HTML/URL 信号探测工具 | scripts/audit_page.py |
| 可复用的实施交接模板 | templates/implementation-brief-template.md |
注意事项
- GEO 不是 Google 独有的技巧层:对于 Google 搜索,应优化搜索体验和基础,而不是另创仅供 AI 使用的标记。
- 索引、排名和展示从不保证:通过技术检查并不保证内容会被选中或展示。
- 预览控件会影响 AI 功能:
nosnippet和限制性max-snippet设置可能限制 AI Overviews 和 AI Mode 对内容的直接使用。 - 结构化数据并非生成式 AI 的要求:仅当它能准确描述可见内容并有助于获得富媒体搜索结果资格时,才使用结构化数据。
- 不要针对每种查询扩展形式批量创建页面:为查询变体批量生成页面可能构成规模化内容滥用。
- 以实际渲染结果为准:框架元数据 API、客户端渲染、Web 组件和 hydration 都可能改变 Google 和 Agent 实际看到的内容。
来源基准
记录的基准是 Google 官方指南,已于 2026 年 5 月 16 日审核,尤其是 AI 优化指南,记录显示其于 2026-05-15 UTC 更新。这是一个有日期的基准,并不意味着所有政策至今仍然有效。
如果差距、不确定的政策或疑似变更会影响任务,请查阅相关的 Google/工具当前官方文档;使用可信来源进行佐证,而非将其作为 Google 政策的替代。其他情况下,重用足够的证据,无需例行浏览。如果无法核实,请说明这一差距。提出有来源支持的修正方案,并在规范包中附上示例或检查;切勿自动编辑已安装的副本。
辅助文件
references/README.md- 来源索引与披露指南。references/google-guidance.md- Google 官方 AI 搜索指南,已改编为面向 Web 开发的内容。references/technical-implementation.md- 实现检查与框架模式。references/content-and-entity-patterns.md- 持久的内容与实体策略。references/ecommerce-local-agentic.md- 电商、本地场景与浏览器 Agent 就绪度。references/gotchas.md- 陷阱、误区与假阳性。scripts/audit_page.py- 针对单个 URL 或 HTML 文件的确定性静态信号审计工具。scripts/validate.py- 此技能的结构验证器。scripts/test_skill.py- 用于测试打包与审计行为的轻量回归测试。templates/implementation-brief-template.md- 可直接用于修复规划的模板。