关于 nextjs-seo
用于在 Next.js 项目中实施和审查 SEO 的技能，强调匹配已安装版本的框架文档、生产环境证据和准确报告，不承诺排名或收录结果。
主要功能
- 01采用与已安装 Next.js 版本匹配的文档
- 02检查元数据、站点地图、robots 和规范链接
- 03核对结构化数据与可见内容
- 04检查生产 HTML、响应头和爬虫响应
- 05区分搜索、收录与性能证据
适用场景
- 01审查 Next.js 路由的 SEO 改动
- 02诊断爬取、收录或规范链接问题
- 03发布前验证元数据和结构化数据
- 04评估现场性能数据，不单凭 Lighthouse 下结论
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/nextjs-seo确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/ai-search.mdchecklist.mdjson-ld.mdmetadata-api.mdsitemap-robots.mdtroubleshooting.md详细介绍
Next.js SEO
从页面的任务、生产环境响应和观察到的搜索行为入手。
读取已安装的 Next.js 版本和相关的 node_modules/next/dist/docs/
页面（随 16.2 捆绑）；否则使用相匹配的官方文档。
Metadata、Viewport 和 MetadataRoute 类型也位于
node_modules/next/dist/lib/metadata/types/metadata-interface.d.ts。确保
框架 API、缓存模式和部署策略与项目保持一致。
有价值且独特的内容比更长的页面更重要。让标题、标题层级和描述各司其职；只有在能帮助读者时，才添加常见问题、摘要、徽章或额外页面。发布日期必须反映有意义的变更。核实作者身份、资质和事实声明。
实施与审查范围
- 在添加标记之前，核实公开 URL、重定向、状态码、抓取规则、索引指令和规范链接。站点地图有助于发现页面，但不能让页面变得可索引，也不能保证页面会被编入索引。
- 在可行的情况下，确保重要的公开内容存在于所提供的 HTML 中。客户端组件可以由服务器预渲染；仅使用
use client并不会让内容从 HTML 中消失。 - 使用 App Router Metadata API 和文件约定。使用正确的生产环境
metadataBase解析相对元数据 URL，并核实生成的绝对 URL。不要依赖不同版本或主机上缺少基础 URL 时的行为。 - 为数据驱动的页面、元数据和站点地图配置刷新/失效机制。仅执行数据库查询并不能保证发布更新能同步到这些内容中。启用 Cache Components 时，请遵循已安装 Next.js 的缓存文档（
node_modules/next/dist/docs/）；缓存属于新鲜度决策，而非必需的 SEO 指令。 - 结构化数据必须描述真实可见的内容，并面向受支持的使用方。请检查当前的富媒体搜索结果资格，而不是添加所有 Schema 类型。
- 遵循站点所有者的爬虫策略。训练、搜索和用户触发的检索具有不同的控制方式；robots 规则不是访问控制。
阅读相关内容
- 元数据：继承、社交图片、图标和流式传输。
- 站点地图/robots：发现、本地化和预览策略。
- 结构化数据：当前资格和安全序列化。
- AI 搜索：爬虫用途、策略和证据。
- 审查清单：范围明确的生产环境和 Search Console 检查。
- 故障排除：索引、HTML 和水合诊断。
在报告中区分不同证据：性能导出数据展示查询/流量； URL Inspection 和索引报告用于判断抓取/索引/规范链接状态； 现场测量数据用于评估 Core Web Vitals。Lighthouse 是实验室诊断工具， 无法证明现场 INP。第 75 百分位的良好现场阈值为 LCP ≤ 2.5 s、INP ≤ 200 ms 和 CLS ≤ 0.1。
核实状态、标头和完整的生产环境 HTML，包括相关爬虫收到的响应，然后直接打开路由并测试其交互。伪造 User-Agent 测试的是响应处理，而非经过实际验证的爬虫访问。明确报告无法执行的检查，并避免承诺排名、索引或引用结果。