关于 nuxt-geo-best-practices
面向 Nuxt 4 应用的 Claude Code Skill,提供 16 条有证据依据的生成式引擎优化规则,涵盖内容、爬虫、实体信息、页面信号和效果测量。
主要功能
- 01涵盖五类的 16 条规则
- 02内容可提取性指南
- 03AI 爬虫与发现配置
- 04结构化数据和页面元数据指南
- 05可见度测量方法
适用场景
- 01添加 llms.txt 和站点地图路由
- 02允许或屏蔽 AI 爬虫
- 03按 RAG 检索需求组织内容
- 04跟踪内容在 AI 答案中的引用
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ vinayakkulkarni/ vue-nuxt-best-practices --skill nuxt-geo-best-practices安装后在 Claude Code 中输入/nuxt-geo-best-practices确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
AGENTS.mdmetadata.jsonpackage.jsonrules/_sections.md_template.mdai-llms-txt.mdai-robots-allowlist.mdai-sitemap.mdai-ssr-for-crawlers.mdcontent-citations.mdcontent-definition-blocks.mdcontent-no-keyword-stuffing.mdcontent-quotations.mdcontent-self-contained-chunks.mdcontent-statistics.mdentity-author-schema.mdentity-faq-howto-schema.mdentity-organization-schema.mdmeasure-aeo-visibility.mdpage-canonical-and-fresh.mdpage-use-page-geo.mdscripts/build.tsvalidate.ts详细介绍
Nuxt GEO 最佳实践
面向 Nuxt 4 应用的全面生成式引擎优化指南。旨在最大限度提高你的品牌在 ChatGPT、Google AI Overviews / AI Mode、Perplexity、Claude 和 Gemini 生成的答案中的引用率。包含 5 个类别中的 16 条规则,并根据有证据支持的影响进行优先级排序。
适用场景
在以下情况下参考这些指南:
- 为 AI Agent 发现配置
llms.txt和llms-full.txt - 在
robots.txt中允许(或屏蔽)AI 爬虫(GPTBot、ClaudeBot、PerplexityBot、Google-Extended 等) - 组织页面内容,以便于检索增强生成(RAG)提取
- 添加 Organization、Person、FAQPage 或 HowTo JSON-LD schema,以明确实体信息
- 应用 GEO arxiv 论文中有证据支持的有效因素:统计数据、引用来源、引言(可提升 30-40% 的曝光度)
- 构建
usePageGeocomposable,为每个页面添加适合 AI 的元数据 - 确保 AI 爬虫能看到 SSR 渲染的 HTML(而非 JavaScript 空壳)
- 生成适合 AI 的 XML 站点地图和
sitemap_index.xml
推荐的 Nuxt 模块
此技能面向 Nuxt 4 应用。以下若干规则同时展示了“从零开始”的 Nitro 路由实现方式和对应的模块快捷方案。强烈建议安装这些模块——它们可以省去大量样板代码,并与 Nuxt 官方模式保持同步:
@nuxtjs/seo,由 Harlan Wilton 开发——元模块,整合了@nuxtjs/sitemap、@nuxtjs/robots、nuxt-schema-org、nuxt-og-image、nuxt-link-checker和nuxt-seo-utils。通过一次安装即可覆盖大部分 GEO 基础设施(robots.txt、站点地图、JSON-LD、元数据)。@nuxtjs/sitemap——自动生成站点地图,支持按页面设置lastmod、hreflang 和排除项。@nuxtjs/robots——以编程方式生成robots.txt,支持按路由控制,以及 AI 机器人的允许/禁止规则。nuxt-schema-org——通过defineOrganization、defineWebSite、defineFaqPage、defineHowTo、definePerson、defineArticle实现类型安全的 JSON-LD。nuxt-og-image——用于 OG/分享图片(相关内容见姊妹技能nuxt-seo-best-practices——请注意其中关于 CF Workers 的说明)。
Nuxt 官方 SEO 元数据文档
Nuxt 4 内置了一流的 SEO/元数据基础功能。在自行实现之前,请先阅读以下文档:
- Nuxt 4 SEO & Meta——
useSeoMeta、useHead、useServerSeoMeta、definePageMeta、<Head>/<Title>/<Meta>组件,以及路由级别的head配置。 useSeoMeta——基于useHead({ meta: [...] })的类型化封装,提供完整的 OG/Twitter 标签 IntelliSense。useHead——通用 head 管理器(此处用于注入 JSON-LDscript)。
page-use-page-geo.md 中的 usePageGeo composable 是对这些基础功能的轻量封装,并非它们的替代品。
**Nuxt 4.5 说明:**head 管理现由
unheadv3 提供——useHead类型更严格,且不再接受 promise 输入。此技能中的useHeadJSON-LD 注入模式使用普通同步值,与 v3 兼容。此外,4.5 的实验性 SSR 流式传输会识别机器人:爬虫会自动收到完整缓冲的 HTML,因此启用它不会影响 GEO(参见ai-ssr-for-crawlers)。
证据基础
这些规则综合自:
- GEO:生成式引擎优化(Aggarwal 等人,KDD 2024,arXiv:2311.09735)——这篇奠基性论文对 1 万条查询中的 9 种优化方法进行了基准测试。本文采用的关键发现:
- 统计数据、引文和引用内容可将可见度提升 最高达 40%
- 权威的语气和流畅度优化可带来中等幅度的提升
- 关键词堆砌(传统 SEO)在生成式引擎中不起作用——不要把 SEO 的关键词密度习惯带入 GEO
- 行业 GEO 指南(Search Engine Land、Semrush AI Visibility Index、Backlinko)——这些资料基于对 Google AI Mode 和 ChatGPT 上 2,500 多条已跟踪提示词的观察,涵盖实体清晰度、多平台曝光度、情感倾向和衡量框架。
- 生产环境 AEO 审计数据(2026)——一个 41 页的 Nuxt 网站经自动化 AEO 评分引擎审计,并在四个答案引擎上进行了多轮可见度跟踪。下方的影响因素权重表、三个持续失效的因素,以及
measure-aeo-visibility中的统计防护措施均源自该数据。关键观察:该网站具备_完整_的 GEO 基础设施(llms.txt、有效的 schema、站点地图、90% 的 Google 索引覆盖率),但在 **0 条(共 10 条)**类别查询中被引用——基础设施是必要条件,但并非充分条件。
按优先级划分的规则类别
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | 内容可提取性(提升 +40% 的关键因素) | 关键 | content- |
| 2 | AI 爬虫与发现 | 关键 | ai- |
| 3 | 实体清晰度 | 高 | entity- |
| 4 | 页面级 GEO | 高 | page- |
| 5 | 衡量与验证 | 关键 | measure- |
已观察到的审计权重(生产环境中的 AEO 审计工具,2026 年)
arxiv 论文告诉你_哪些杠杆能提升可见度_,自动化 AEO 审计则能告诉你_评分引擎实际如何为页面分配权重_。这些权重来自对一个包含 41 个页面的 Nuxt 网站进行的生产环境审计;当所有方面同时出现问题时,可据此优先安排修复工作:
| 因素 | 权重 | 典型得分 | 备注 |
|---|---|---|---|
| 结构化数据(JSON-LD) | 12% | 部分通过 | entity-organization-schema |
| 内容深度 | 10% | 通过 | content-statistics、content-self-contained-chunks |
| 引用与权威性信号 | 8% | 部分通过 | content-citations |
| E-E-A-T 信号 | 8% | 未通过(26) | entity-author-schema — 常见问题中得分最低 |
| FAQ 内容 | 8% | 未通过(31) | entity-faq-howto-schema |
| Schema 完整性 | 8% | 通过 | entity-faq-howto-schema |
| 内容时效性 | 7% | 部分通过 | page-canonical-and-fresh |
| 实体一致性 | 7% | 部分通过 | title / og:title / schema name 必须一致 |
| 内容可提取性 | 6% | 部分通过 | content-self-contained-chunks |
| 定义块 | 6% | 未通过(12) | content-definition-blocks — 得分最低 |
| 命名实体 | 6% | 通过 | entity-organization-schema |
| 摘要片段资格 | 6% | 通过 | — |
| AI 访问文件(llms.txt) | 5% | 通过 | ai-llms-txt |
| Schema 有效性 | 5% | 通过 | — |
| 技术 SEO | 5% | 通过 | 同级技能 nuxt-seo-best-practices |
| AI 爬虫访问 | 4% | 部分通过 | ai-robots-allowlist |
三个持续未通过的因素——E-E-A-T(8%)、FAQ 内容(8%)、定义块(6%)——合计占总分的 22%,而且是最容易修复的因素之一。 网站往往已经配置了完美的 llms.txt、有效的 schema,并获得 Google 90% 的索引覆盖率,但这三项的得分仍为 0。先从这里着手。
经典 SEO 健康度不代表 AEO 可见度。 受审计的网站在自己的品牌名称搜索中排名第 3.9,索引覆盖率达到 90%,但在十个类别查询中一个也未被引用。品牌搜索和类别发现是两个不同的问题——请参阅
measure-aeo-visibility。
快速参考
1. 内容可提取性(关键)
这些是 GEO arxiv 论文中有证据支持、可提升可见度 30%–40% 的杠杆。如果只做三件事,就做这三件。
content-statistics— 添加定量统计数据(实测提升幅度最大的单项改动)content-citations— 添加可信来源的行内引用(Sources 组件模式)content-quotations— 添加权威人士的引述content-self-contained-chunks— 撰写提取后仍能保留原意的段落(RAG 检索)content-definition-blocks— 采用“What is X” / “How to X”结构;真实审计中得分最低的因素(12/100)content-no-keyword-stuffing— 切勿把 SEO 关键词堆砌带入 GEO;这会直接损害可见度
2. AI 爬虫与发现(关键)
如果 AI 爬虫无法访问你的内容,其他规则都无关紧要。
ai-llms-txt— 通过 Nitro 服务路由生成llms.txt和llms-full.txtai-robots-allowlist— 明确允许 GPTBot、ClaudeBot、PerplexityBot、Google-Extended 等ai-ssr-for-crawlers— 确保 AI 爬虫收到的是渲染后的 HTML,而不是 JS 外壳ai-sitemap— 生成适合 AI 的 XML 站点地图,并附带lastmod,提供内容新鲜度信号
3. 实体清晰度(高)
帮助 AI 系统辨别你是谁、属于什么类别,以及在哪些方面具有权威性。
entity-organization-schema— 全站 Organization JSON-LD,并通过sameAs进行交叉引用entity-faq-howto-schema— FAQPage 和 HowTo Schema,适用于大模型青睐的问句式查询entity-author-schema— Person Schema,包含资历信息和用于 E-E-A-T 的sameAs
4. 页面级 GEO(高)
page-use-page-geo— 可复用的usePageGeo组合式函数,用于设置每个页面的 GEO 元数据page-canonical-and-fresh— 规范 URL +dateModified,提供内容新鲜度信号
5. 测量与验证(关键)
没有这一项,以上内容都无法证伪。生成式引擎具有随机性——同一查询可能在一次扫描中引用了内容,下一次却没有,而内容本身毫无变化。
measure-aeo-visibility— 重复采样、声量占比、Wilson 区间、每月至少扫描 5 次的要求,以及提及与引用的区别
如何使用
阅读各规则文件,了解详细说明和代码示例:
rules/content-statistics.md
rules/ai-llms-txt.md
rules/_sections.md
每个规则文件都包含:
- 简要说明规则的重要性(适用时附带 arxiv 证据)
- 错误代码示例及说明
- Nuxt 专用的正确代码示例
- 补充背景、测量说明和参考资料
完整汇编文档
如需查看包含所有展开规则的完整指南,请参阅:AGENTS.md