mcpField
S
seo-page

seo-page

github.com/agricidaniel营销与增长89477 次安装2 周前更新
代码仓库

关于 seo-page

用于检查单个页面的页面 SEO、内容、技术元素、结构化数据和图像的技能。它按优先级整理问题并给出可执行建议，也可选用 DataForSEO MCP 查询并使用共享缓存。

主要功能

  1. 01页面 SEO 检查
  2. 02内容质量评估
  3. 03技术元数据检查
  4. 04结构化数据审查
  5. 05图像优化检查
  6. 06按优先级整理问题与建议

适用场景

  1. 01发布前审查页面
  2. 02查找缺失的元数据和结构化数据
  3. 03检查图像的无障碍信息与大小
  4. 04在 SEO 工作中复用缓存结果

MCP 相关

该技能可选用 DataForSEO MCP 工具查询实时自然搜索结果和反向链接数据。

安装

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

$npx skills add https://github.com/agricidaniel/codex-seo --skill seo-page

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

附带文件LICENSE.txt

详细介绍

单页分析

共享数据缓存

步骤 0 —— 检查共享数据缓存：

开始收集信息前，检查 .seo-cache/，查看是否有可从相关 SEO 技能中复用的上下文。 参考 ../seo/references/shared-data-cache.md，了解架构和依赖关系图。

如果存在，请检查以下缓存文件：

  • .seo-cache/site-meta.json：域名、业务类型、行业和爬取上下文

  • .seo-cache/audit-scores.json：此前完整审计的优先级

  • .seo-cache/pages/{url-slug}/page-analysis.json：提供 URL 时的页面级上下文

  • 如果找到：解析并使用明显有效的字段（注明“使用了来自 [date] 的缓存 [X]”）

  • 如果缺失、损坏或不相关：继续收集新证据

  • 如果用户说“refresh”或“re-run”：忽略缓存读取，并在写入时覆盖

分析内容

页面 SEO
  • Title 标签：50-60 个字符，包含主要关键词，且具有唯一性
  • Meta description：150-160 个字符，具有吸引力并包含关键词
  • H1：恰好一个，符合页面意图并包含关键词
  • H2-H6：层级合理（不能跳级），描述清晰
  • URL：简短、描述性强、使用连字符、不含参数
  • 内部链接：数量充足，锚文本相关，不存在孤立页面
  • 外部链接：指向权威来源，数量合理
内容质量
  • 字数与页面类型最低要求的对比（参见 quality-gates.md）
  • 可读性：Flesch 阅读易读度分数、年级水平
  • 关键词密度：自然（1-3%），包含语义变体
  • E-E-A-T 信号：作者简介、资质、第一手经验标记
  • 内容时效性：发布日期、最后更新日期
技术元素
  • Canonical 标签：存在，且指向自身或正确的页面
  • 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（仅限政府/医疗领域）
图片
  • 替代文本：存在、描述性强，并在自然的情况下包含关键词
  • 文件大小：标记 >200KB（警告）、>500KB（严重）
  • 格式：建议使用 WebP/AVIF，而非 JPEG/PNG
  • 尺寸：设置 width/height 以防止 CLS
  • 延迟加载：对首屏以下的图片设置 loading="lazy"
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，并指出结果可能不完整。如果有浏览器渲染的快照，建议使用该快照。

写入共享数据缓存

完成所有工作后，如果工作流产生了持久性发现，请将简洁的 JSON 摘要写入 .seo-cache/。 使用 ../seo/references/shared-data-cache.md 中的架构和命名规则；至少包含 cache_type、analyzed_at、来源 URL／域名、关键发现、问题、建议和工具限制。如果 .gitignore 中没有 .seo-cache/，请将其添加进去。

评论

支持 Markdown