先看效果：

为什么做这个工具？

做 SEO 的都知道，审计是个苦力活：

• 要检查 robots.txt、sitemap.xml、canonical 标签……
• 要看 TDK(Title/Description/Keywords）写得对不对
• 要分析 H1/H2 结构、内链分布、Schema 标记
• 还要跑 PageSpeed Insights，看性能分数

这些事儿，80% 是机械重复，20% 需要人工判断。

比如：

• “这个页面的 title 是不是 50-60 字符？” → 机器能判断
• “这个 H1 的语义是否匹配关键词意图？” → 需要 LLM 理解

所以我设计了一个 Script + LLM 双层架构：

• Layer 1(Python 脚本） 处理确定性检查 → 输出结构化 JSON
• Layer 2(LLM Agent) 处理语义判断 → 只在需要时介入

这样既不会让 LLM 瞎编（比如说“robots.txt 存在”但其实不存在），也不会漏掉需要理解的部分（比如 H1 的语义匹配度）。

能检查什么？

目前 v1.0 支持 20+ 项 SEO 检查，分为两个版本：

seo-audit (Basic 版）

适合日常快速审计，给个 URL 就能跑：

站点级检查：

• ✅ robots.txt 解析（RFC 9309 标准）
• ✅ sitemap.xml 验证
• ✅ 404 处理（真 404 vs 软 404 vs 重定向到首页）
• ✅ URL 规范化（HTTP→HTTPS、www 一致性、尾部斜杠）
• ✅ 国际化 / hreflang 标签
• ✅ Schema(JSON-LD）验证
• ✅ E-E-A-T 信任页面（About/Contact/Privacy/Terms）
• ✅ PageSpeed Insights 分数（移动端 + 桌面端）

页面级检查：

• ✅ URL Slug（小写、连字符、关键词、停用词检测）
• ✅ Title 标签（50-60 字符、关键词位置）
• ✅ Meta Description(120-160 字符、关键词匹配、具体价值主张）
• ✅ H1 标签（单一 H1、关键词匹配、语义意图）
• ✅ Canonical 标签（自引用、重定向后匹配）
• ✅ 图片 Alt 文本
• ✅ 字数统计（正文 ≥ 500 字）
• ✅ 关键词位置（前 100 字内）
• ✅ 标题结构（H2 数量、H3/H2 比例、关键词分布）
• ✅ 内链分布

怎么用？

超简单，两种方式：

方式 1: CLI（推荐）

npx skills add JeffLi1993/seo-audit-skill

# 或者安装指定版本
npx skills add JeffLi1993/seo-audit-skill --skill seo-audit
npx skills add JeffLi1993/seo-audit-skill --skill seo-audit-full

方式 2: Claude Code 插件

/plugin marketplace add JeffLi1993/seo-audit-skill
/plugin install seo-audit-skill

然后直接对话：

audit this page: https://example.com

就能生成报告了！

项目结构

seo-audit-skill/
├── seo-audit/
│   ├── SKILL.md                       # Skill 定义 + agent 工作流
│   ├── references/REFERENCE.md        # 字段定义、边界情况
│   ├── assets/report-template.html    # HTML 输出模板