关于 seo-onpage
seo-onpage 是一项不依赖技术栈的技能,用于优化单个页面的搜索相关性、点击率和爬虫可读性。它按八个维度检查页面并排列修复优先级。
主要功能
- 01八维度页面审查
- 02标题与元描述检查
- 03标题层级与内容结构检查
- 04内链与媒体检查
- 05URL 路径与结构化数据检查
适用场景
- 01审查首页或落地页
- 02检查搜索标题和描述
- 03改进页面结构与内部链接
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ rampstackco/ claude-skills --skill seo-onpage安装后在 Claude Code 中输入/seo-onpage确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdreferences/audit-template.mdonpage-checklist.mdtitle-and-meta-patterns.md详细介绍
页面 SEO
优化单个页面,提升搜索相关性、点击率和爬虫理解能力。与技术栈无关,适用于任何 CMS、框架或静态网站。
适用场景
- 审核或优化单个页面(首页、产品页、文章、着陆页)
- 编写或审查标题标签和元描述
- 修正标题结构或内容层级
- 审查指向某个页面或来自某个页面的内部链接
- 提升页面在搜索结果中的点击率
不适用场景
- 全站抓取、索引或速度问题(使用
seo-technical) - 关键词研究或搜索意图映射(使用
seo-keyword) - 竞争对手 SERP 分析(使用
seo-competitor) - 一次性审核多个页面以决定精简或合并(使用
seo-content-audit)
必需输入
- 页面 URL;如果尚未上线,则提供草稿内容
- 主要目标查询词(页面希望获得排名的一个短语)
- 页面在网站中的作用(商业、信息或导航)
如果目标查询词未知,请先运行 seo-keyword,或请用户提供一个。
框架:8 个维度
完整的页面 SEO 审核涵盖八个维度。每项评为通过、需要改进或失败,并注明具体修复措施。
1. 标题标签
- 全站范围内,每个 URL 都有唯一标题
- 长度约为 50 至 60 个字符(过长会在 SERP 中被截断)
- 主要查询词靠前
- 如有必要,在末尾添加品牌名称
- 与 H1 有区别(通常非常相似,但不应逐字完全相同)
2. 元描述
- 每个 URL 都有唯一描述
- 长度约为 150 至 160 个字符
- 重申价值主张,而不是重复标题
- 自然时加入柔性 CTA
- 将描述视为能吸引用户点击的广告文案
3. 标题结构
- 每个页面恰好有一个 H1
- H1 包含或转述主要查询词
- H2 章节涵盖主要子主题
- 仅当 H2 下确有子要点时才使用 H3 或更低级别标题
- 不跳过级别(例如 H2 后直接跟 H4)
- 标题应准确描述章节内容,让读者仅凭标题就能浏览页面
4. 正文内容
- 开篇第一段就回答用户的主要意图
- 全面涵盖主题(先确定竞争对手内容的深度,再达到或超越该深度)
- 自然地纳入相关实体和辅助概念
- 避免关键词堆砌(为读者而写,而不是为机器人)
- 阅读难度应与受众相符(进行可读性检查)
- 段落应足够简短,便于在移动设备上快速浏览(3 至 5 行)
5. 内部链接
- 至少添加 2 至 3 个指向密切相关页面的内部链接
- 至少获得 2 至 3 个来自相关页面的内部链接
- 锚文本应描述清晰,不要使用“点击此处”或“了解更多”
- 链接应指向规范 URL,而不是重定向链接
- 不得存在失效的内部链接
6. 图片和媒体
- 每张有意义的图片都应有描述性替代文本(纯装饰性图片可省略替代文本)
- 文件名应具有描述性(使用 "blue-running-shoe.jpg",而不是 "IMG_4032.jpg")
- 在支持的情况下使用现代格式(WebP、AVIF)
- 对首屏以下的图片启用延迟加载
- 设置宽度和高度属性,防止布局偏移
7. URL 路径
- 使用小写字母,以连字符分隔
- 自然地包含主要查询词(不要堆砌)
- 尽可能保持简短(少于 60 个字符)
- 除非页面内容确实与时间相关,否则不要包含日期
- 不包含会话 ID、跟踪参数或随机哈希
- 符合网站的 URL 格式规范
8. 页面结构化数据
- 根据内容选择适当的 Schema.org 类型(Article、Product、FAQPage、HowTo、Recipe 等)
- 填写必需属性(查看对应类型的 Schema.org 文档)
- 通过 Google 的 Rich Results Test 或同类工具验证
- 与页面上可见的内容一致(不要欺骗爬虫)
- 内容页面的作者和发布者结构化数据应正确关联
工作流
- 确认目标查询。 如果不明确,请提问。没有目标查询时,不要进行优化。
- 渲染页面。 以用户的视角查看页面。从上到下阅读内容。
- 查看渲染后的 HTML。 检查实际提供的标记,而不只是页面的视觉呈现。检查源代码中的
<title>、<meta>、标题和架构标记。 - 运行 8 维框架。 为每个维度评分,并记录具体的修复措施。
- 确定优先级。 将修复分为关键(损坏或缺失)、重要(不够理想)和锦上添花(润色)。
- 撰写报告。 使用
references/audit-template.md中的模板。 - 提出起草修复方案。 如果用户需要,可直接起草新的标题、元描述、标题层级或文案。
常见失败模式
发现以下情况时,请在交付前提出异议。
- “让 SEO 效果更好。” 目标模糊。先询问目标查询和当前的问题。
- “在正文中把关键词加 5 次。” 关键词密度并不是真正的排名信号。应优先提升相关性和主题深度。
- 优化无法抓取或无法编入索引的页面。 先检查
seo-technical。对于禁止编入索引的页面,页面内优化无济于事。 - 优化没有明确用户意图的页面。 如果页面无法满足真实查询,无论标签优化得多好,都无法获得排名。
- 针对网站上另一个页面的同一查询进行优化。 这是关键词蚕食。使用
seo-content-audit判断哪个页面应该获得排名。
输出格式
默认输出为项目根目录中的 Markdown 审核报告 seo-audit-[page-slug].md。结构如下:
- 页面摘要(URL、目标查询、页面角色)
- 8 个维度的评分
- 关键修复
- 重要修复
- 锦上添花的润色
- 起草的替换内容(如有要求)
审核报告应控制在 1500 词以内。如果页面需要更详细的说明,请链接到更深入的附录。
参考文件
references/audit-template.md- 可填写的审核模板,可复制使用。references/onpage-checklist.md- 8 个维度的速查清单。references/title-and-meta-patterns.md- 撰写优质标题和元描述的模式。
评论
支持 Markdown