mcpField
N
nuxt-geo-best-practices

nuxt-geo-best-practices

github.com/vinayakkulkarni营销与增长4345 次安装14 周前更新
代码仓库

关于 nuxt-geo-best-practices

面向 Nuxt 4 应用的 Claude Code Skill,提供 16 条有证据依据的生成式引擎优化规则,涵盖内容、爬虫、实体信息、页面信号和效果测量。

主要功能

  1. 01涵盖五类的 16 条规则
  2. 02内容可提取性指南
  3. 03AI 爬虫与发现配置
  4. 04结构化数据和页面元数据指南
  5. 05可见度测量方法

适用场景

  1. 01添加 llms.txt 和站点地图路由
  2. 02允许或屏蔽 AI 爬虫
  3. 03按 RAG 检索需求组织内容
  4. 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.md
metadata.json
package.json
rules/
_sections.md
_template.md
ai-llms-txt.md
ai-robots-allowlist.md
ai-sitemap.md
ai-ssr-for-crawlers.md
content-citations.md
content-definition-blocks.md
content-no-keyword-stuffing.md
content-quotations.md
content-self-contained-chunks.md
content-statistics.md
entity-author-schema.md
entity-faq-howto-schema.md
entity-organization-schema.md
measure-aeo-visibility.md
page-canonical-and-fresh.md
page-use-page-geo.md
scripts/
build.ts
validate.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% 的曝光度)
  • 构建 usePageGeo composable,为每个页面添加适合 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-LD script)。

page-use-page-geo.md 中的 usePageGeo composable 是对这些基础功能的轻量封装,并非它们的替代品。

**Nuxt 4.5 说明:**head 管理现由 unhead v3 提供——useHead 类型更严格,且不再接受 promise 输入。此技能中的 useHead JSON-LD 注入模式使用普通同步值,与 v3 兼容。此外,4.5 的实验性 SSR 流式传输会识别机器人:爬虫会自动收到完整缓冲的 HTML,因此启用它不会影响 GEO(参见 ai-ssr-for-crawlers)。

证据基础

这些规则综合自:

  1. GEO:生成式引擎优化(Aggarwal 等人,KDD 2024,arXiv:2311.09735)——这篇奠基性论文对 1 万条查询中的 9 种优化方法进行了基准测试。本文采用的关键发现:
    • 统计数据、引文和引用内容可将可见度提升 最高达 40%
    • 权威的语气和流畅度优化可带来中等幅度的提升
    • 关键词堆砌(传统 SEO)在生成式引擎中不起作用——不要把 SEO 的关键词密度习惯带入 GEO
  2. 行业 GEO 指南(Search Engine Land、Semrush AI Visibility Index、Backlinko)——这些资料基于对 Google AI Mode 和 ChatGPT 上 2,500 多条已跟踪提示词的观察,涵盖实体清晰度、多平台曝光度、情感倾向和衡量框架。
  3. 生产环境 AEO 审计数据(2026)——一个 41 页的 Nuxt 网站经自动化 AEO 评分引擎审计,并在四个答案引擎上进行了多轮可见度跟踪。下方的影响因素权重表、三个持续失效的因素,以及 measure-aeo-visibility 中的统计防护措施均源自该数据。关键观察:该网站具备_完整_的 GEO 基础设施(llms.txt、有效的 schema、站点地图、90% 的 Google 索引覆盖率),但在 **0 条(共 10 条)**类别查询中被引用——基础设施是必要条件,但并非充分条件。

按优先级划分的规则类别

优先级类别影响前缀
1内容可提取性(提升 +40% 的关键因素)关键content-
2AI 爬虫与发现关键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%通过—
技术 SEO5%通过同级技能 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.txt
  • ai-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

评论

支持 Markdown