mcpField
S
seo-regression-validator

seo-regression-validator

github.com/sergekostenchuk测试与质量3249 次安装18 周前更新
代码仓库

关于 seo-regression-validator

供 SEO 专业人员使用的验证技能，在技术 SEO 指导就绪后检查线上 HTML 或本地样例。它记录带时间戳的证据、分类检查结果并生成回归报告，不会修改目标网站。

主要功能

  1. 01检查线上 HTML 和本地样例
  2. 02验证结构化数据与 head 元数据
  3. 03分类失败、警告和跳过项
  4. 04记录带时间戳的证据报告
  5. 05检查公开资源是否可访问

适用场景

  1. 01发布前审查 SEO 元数据
  2. 02检查预期包含 JSON-LD 的页面
  3. 03依据证据跟踪回归问题

安装

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

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill seo-regression-validator

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

包含的文件

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

evals.json
agents/
openai.yaml
fixtures/
bad-news.html
bad-news.report.json
good-news.html
good-news.report.json
references/
regression-checklist.md
scripts/
audit_static_seo.py

详细介绍

SEO 回归验证器

在技术 SEO／结构化数据指导已存在后、声称网站或技能输出已完成前，使用此技能。

运行广泛审计前，请阅读 references/regression-checklist.md。

负责范围

  • 在线 HTML 和本地测试夹具检查；
  • 通过／失败严重性模型；
  • 带时间戳的证据报告；
  • 结构化数据／head 元数据检查；
  • 公共产物可访问性检查；
  • 回归报告模板；
  • 针对缺少 JSON-LD、重复 canonical、缺少图片和虚假报告的负向测试。

不负责

  • 实施 SEO 修复；
  • 通过 Search Console 凭据访问数据；
  • 分析数据导出；
  • 外部权威渠道投放；
  • 修改目标网站。

工作流

  1. 定义目标 URL 或测试夹具文件。
  2. 记录时间戳、目标、方法和用户代理。
  3. 获取或读取目标，不进行任何修改。
  4. HTML 可用时，使用 scripts/audit_static_seo.py 运行确定性检查。
  5. 将严重失败、警告和跳过的检查分别列出。
  6. 记录跳过的检查，不要将其视为通过。
  7. 生成或更新 seo-regression-report.json 和便于阅读的验证摘要。
  8. 将修复工作交给相应的专业人员。

默认严重问题

  • 缺少 <title>；
  • 缺少 meta description；
  • 缺少 canonical 或 canonical 重复；
  • 预期应包含结构化数据的页面没有 JSON-LD；
  • JSON-LD 无效；
  • NewsArticle 没有可用图片；
  • 在线检查期间，公共页面被阻止访问或无法访问；
  • 报告声称成功，但未获取或读取目标。

默认警告

  • 预期存在多语言对应版本，但缺少 hreflang；
  • 缺少 OG／Twitter 社交标签；
  • 缺少 RSS 自动发现；
  • 缺少 viewport；
  • 存在文章结构化数据，但缺少文章 meta 标签；
  • 预期应有 BreadcrumbList，但页面没有可见的面包屑导航；
  • 未测量性能指标。

安全与隐私边界

  • 不要修改目标网站。
  • 除非用户明确为此任务提供凭据，否则不要使用凭据。
  • 不要在报告中存储 Cookie、令牌、原始私人分析数据、原始 IP 日志或私人 Search Console 数据行。
  • 不要仅凭一次 HTML 检查就声称了解排名、索引、引用或爬虫行为。

验证

使用以下内容验证技能修改：

python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/seo-regression-validator
python3 $HOME/SKILL/skills/seo-regression-validator/scripts/audit_static_seo.py $HOME/SKILL/skills/seo-regression-validator/fixtures/good-news.html
python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

前向测试位于 evals.json。

输出格式

返回：

  1. 已检查的目标。
  2. 严重问题。
  3. 警告。
  4. 跳过的检查。
  5. 证据路径或 URL。
  6. 每项修复的负责人。

评论

支持 Markdown