mcpField
S
seo-onpage

seo-onpage

github.com/rampstackco营销与增长1.0k295 次安装1 周前更新
代码仓库

关于 seo-onpage

seo-onpage 是一项不依赖技术栈的技能,用于优化单个页面的搜索相关性、点击率和爬虫可读性。它按八个维度检查页面并排列修复优先级。

主要功能

  1. 01八维度页面审查
  2. 02标题与元描述检查
  3. 03标题层级与内容结构检查
  4. 04内链与媒体检查
  5. 05URL 路径与结构化数据检查

适用场景

  1. 01审查首页或落地页
  2. 02检查搜索标题和描述
  3. 03改进页面结构与内部链接

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rampstackco/claude-skills --skill seo-onpage

安装后在 Claude Code 中输入/seo-onpage确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
audit-template.md
onpage-checklist.md
title-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 或同类工具验证
  • 与页面上可见的内容一致(不要欺骗爬虫)
  • 内容页面的作者和发布者结构化数据应正确关联

工作流

  1. 确认目标查询。 如果不明确,请提问。没有目标查询时,不要进行优化。
  2. 渲染页面。 以用户的视角查看页面。从上到下阅读内容。
  3. 查看渲染后的 HTML。 检查实际提供的标记,而不只是页面的视觉呈现。检查源代码中的 <title>、<meta>、标题和架构标记。
  4. 运行 8 维框架。 为每个维度评分,并记录具体的修复措施。
  5. 确定优先级。 将修复分为关键(损坏或缺失)、重要(不够理想)和锦上添花(润色)。
  6. 撰写报告。 使用 references/audit-template.md 中的模板。
  7. 提出起草修复方案。 如果用户需要,可直接起草新的标题、元描述、标题层级或文案。

常见失败模式

发现以下情况时,请在交付前提出异议。

  • “让 SEO 效果更好。” 目标模糊。先询问目标查询和当前的问题。
  • “在正文中把关键词加 5 次。” 关键词密度并不是真正的排名信号。应优先提升相关性和主题深度。
  • 优化无法抓取或无法编入索引的页面。 先检查 seo-technical。对于禁止编入索引的页面,页面内优化无济于事。
  • 优化没有明确用户意图的页面。 如果页面无法满足真实查询,无论标签优化得多好,都无法获得排名。
  • 针对网站上另一个页面的同一查询进行优化。 这是关键词蚕食。使用 seo-content-audit 判断哪个页面应该获得排名。

输出格式

默认输出为项目根目录中的 Markdown 审核报告 seo-audit-[page-slug].md。结构如下:

  1. 页面摘要(URL、目标查询、页面角色)
  2. 8 个维度的评分
  3. 关键修复
  4. 重要修复
  5. 锦上添花的润色
  6. 起草的替换内容(如有要求)

审核报告应控制在 1500 词以内。如果页面需要更详细的说明,请链接到更深入的附录。


参考文件

评论

支持 Markdown