mcpField
S
seo-page

seo-page

github.com/agricidaniel营销与增长23.3k7.0k 次安装6 天前更新
代码仓库

关于 seo-page

seo-page 是分析单个网页 SEO 的技能,检查页面内容、技术元数据、结构化数据和图片,并生成评分卡、优先级问题及可执行建议。

主要功能

  1. 01页面 SEO 与内容审查
  2. 02技术元数据检查
  3. 03结构化数据分析
  4. 04图片与加载方式检查
  5. 05评分卡与优先级建议

适用场景

  1. 01发布前审查网页
  2. 02查找元数据和标题层级问题
  3. 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