关于 seo-page
seo-page 是分析单个网页 SEO 的技能,检查页面内容、技术元数据、结构化数据和图片,并生成评分卡、优先级问题及可执行建议。
主要功能
- 01页面 SEO 与内容审查
- 02技术元数据检查
- 03结构化数据分析
- 04图片与加载方式检查
- 05评分卡与优先级建议
适用场景
- 01发布前审查网页
- 02查找元数据和标题层级问题
- 03发现结构化数据与图片改进点
MCP 相关
如果可用,技能可调用 DataForSEO MCP 工具获取实时搜索结果排名和反向链接数据。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ agricidaniel/ claude-seo --skill seo-page安装后在 Claude Code 中输入/seo-page确认已加载。
附带文件LICENSE.txt
详细介绍
单页分析
分析内容
页面内 SEO
- 标题标签:50–60 个字符,包含主要关键词,且内容独特
- Meta 描述:150–160 个字符,具有吸引力,包含关键词
- Meta 描述不能复述标题:运行
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run metadata_template.py --title "<title>" --description "<desc>" --json(基于启发式的确定性字符串比较)。如果描述开头重复标题,结尾又使用模板化的 CTA(“立即免费试用。”、“免费开始!”),那么这就是模板化元数据,也是批量生成任务在整个网站上产出的典型形式。无论正文文案多么原创,重复或模板化的元数据都是有据可查的内容质量问题 - H1:恰好一个,与页面意图相符,并包含关键词
- H2–H6:层级合理(不跳级),描述性明确
- URL:简短、描述性强、使用连字符,不含参数
- 内部链接:数量充足,锚文本相关,避免存在孤立页面
- 外部链接:指向权威来源,数量合理
内容质量
- 字数是否达到页面类型的最低要求(参见 quality-gates.md)
- 可读性:Flesch 阅读易读度分数、年级水平
- 关键词密度:自然(1–3%),包含语义变体
- E-E-A-T 信号:作者简介、资质、亲身经验标记
- 内容新鲜度:发布日期、最后更新日期
技术元素
- Canonical 标签:存在,且指向自身或正确的 URL
- Meta robots:除非有意屏蔽,否则应设为 index/follow
- Open Graph:og:title、og:description、og:image、og:url
- Twitter Card:twitter:card、twitter:title、twitter:description
- Hreflang:适用于多语言页面,且实现正确
Schema 标记
- 检测所有类型(优先使用 JSON-LD)
- 验证必需属性
- 找出缺失的机会
- 切勿推荐 HowTo(已弃用)或用于富媒体搜索结果的 FAQ(已于 2026 年 5 月退役);现有的 FAQPage 无需移除,真正的问答应使用 QAPage
图片
- Alt 文本:存在、描述性明确,并在自然的情况下包含关键词
- 文件大小:标记大于 200KB(警告)和大于 500KB(严重)
- 格式:建议使用 WebP/AVIF,而非 JPEG/PNG
- 尺寸:设置宽度/高度以防止 CLS
- 懒加载:报告每张图片的
lazy_method(native | perfmatters | ewww | js-generic | none)。检测到 JS 懒加载器(Perfmatters、EWWW、lazysizes)时,不要标记“未懒加载”,因为它们会有意移除原生的loading="lazy"属性,并使用data-src占位符
Core Web Vitals(仅供参考,无法仅根据 HTML 测量)
- 标记潜在的 LCP 问题(巨大的主视觉图片、阻塞渲染的资源)
- 标记潜在的 INP 问题(繁重的 JS、缺少 async/defer)
- 标记潜在的 CLS 问题(缺少图片尺寸、注入内容)
输出
页面评分卡
Overall Score: XX/100
On-Page SEO: XX/100 ████████░░
Content Quality: XX/100 ██████████
Technical: XX/100 ███████░░░
Schema: XX/100 █████░░░░░
Images: XX/100 ████████░░
发现的问题
按优先级整理:严重 -> 高 -> 中 -> 低
建议
提供具体、可执行且预期影响明确的改进建议
Schema 建议
针对已发现的机会提供可直接使用的 JSON-LD 代码
DataForSEO 集成(可选)
如果 DataForSEO MCP 工具可用,请使用 serp_organic_live_advanced 获取真实 SERP 排名,并使用 backlinks_summary 获取反向链接数据和垃圾链接分数。
错误处理
| 情况 | 操作 |
|---|---|
| URL 无法访问(DNS 故障、连接被拒绝) | 清楚报告错误。不要猜测页面内容。建议用户核实 URL 并重试。 |
| 页面需要身份验证(401/403) | 报告页面需要身份验证。建议用户直接提供渲染后的 HTML,或提供可公开访问的 URL。 |
| 由 JavaScript 渲染的内容(HTML 中正文为空) | 说明关键内容可能在客户端渲染。分析可用的 HTML,并指出结果可能不完整。建议在有条件时使用浏览器渲染的快照。 |
评论
支持 Markdown