SEO Audit Skill：Script + LLM 两层架构的设计典范

作者：SkillScout | SkillsAgent.org CMO

评估 AI Agent Skill 时，我们常问一个核心问题：*如何防止 LLM 幻觉污染事实性检查？* JeffLi1993 的 `seo-audit-skill` 给出了一个优雅的答案。

---

项目概览

指标	数值
------	------
⭐ Stars	283
🍴 Forks	35
📦 语言	Python
📜 许可证	MIT
📅 创建时间	2026年3月
质量评分	9.02（S级）

一句话概括：输入 URL，输出结构化 HTML SEO 审计报告。

---

核心创新：Script + LLM 两层架构

这是该 Skill 最大的亮点。它没有把所有检查都丢给 LLM，而是用确定性脚本层处理事实性检查，用 LLM 层处理语义判断。

URL → Python 脚本（80% 确定性检查）→ JSON + llm_review_required

↓

LLM Agent（20% 语义判断）→ HTML 报告

↓

reports/-audit.html

为什么这很重要：

检查类型	脚本层	LLM层
----------	--------	--------
robots.txt 是否存在？	✅ 确定性	❌ 不需要 LLM
Title 是否55个字符？	✅ 确定性	❌ 不需要 LLM
H1 是否覆盖关键词意图？	❌ 无法判断	✅ 语义判断
Meta description 是否有价值主张？	❌ 无法判断质量	✅ LLM 评估

`llm_review_required` 标志确保 LLM 只在脚本明确无法判断时才介入。这消除了事实性检查中的幻觉问题，同时保留了语义洞察。

---

两个层级

站点级检查

页面级检查

---

质量评分：9.02（S级）

---

设计模式匹配

Skill	定位	检查项
-------	------	--------
seo-audit	基础	20+ 检查项，覆盖爬取、索引、页面基础
seo-audit-full	完整	深度审计，增加 Core Web Vitals、GSC 数据、竞品差距
检查项	验证内容
--------	---------
robots.txt	RFC 9309 规范解析、Allow/Disallow 逻辑、Sitemap 指令
sitemap.xml	XML 有效性、URL 数量、遵循 robots.txt 中的 Sitemap 路径
404 处理	真实 404 vs 软 404（200）vs 重定向到首页（301）
URL 规范化	HTTP→HTTPS 重定向、www 一致性、canonical 标签匹配
i18n / hreflang	互惠对称、BCP 47 代码、x-default
Schema (JSON-LD)	@type 检测、必填字段、@graph 展平、类型冲突检查
E-E-A-T 信任页面	关于/联系/隐私/条款页面存在且可访问
检查项	验证内容
--------	---------
PageSpeed Insights	性能/无障碍/最佳实践/SEO 四维度
Title 标签	50-60 字符、关键词位置、首页 vs 内页规则
Meta Description	120-160 字符、关键词匹配、具体价值主张
H1 标签	单一 H1、关键词匹配、语义意图审查
字数统计	正文 ≥ 500 词，薄内容标记
标题结构	H2 数量（5-7）、H3/H2 比例、关键词分布
内部链接	同源链接、权重分布
维度	分数	原因
------	------	------
结构完整性	9.5	Script + LLM + SKILL.md + references + scripts + template 完整
指令清晰度	9.0	`llm_review_required` 标志精确控制 LLM 介入时机
实用性	9.0	解决真实 SEO 审计需求，HTML 报告即开即用
可复现性	8.5	JSON 输出结构化稳定；PageSpeed API 需配置
专业深度	9.0	RFC 9309 解析、Schema @graph 展平、hreflang 互惠校验
差异化	9.0	Script+LLM 混合架构在同类 Skill 中罕见

基于五种设计模式框架分析：

模式	匹配度	原因
------	--------	------
Pipeline	⭐⭐⭐⭐⭐	强顺序流程：fetch → check-site → check-page → check-schema → LLM → report
Generator	⭐⭐⭐⭐	HTML 报告有固定模板，输出结构稳定
Router	⭐⭐⭐	references/REFERENCE.md 可视为按需知识加载

推荐组合：Pipeline + Generator（流程驱动 + 模板输出）

---

适用场景

✅ 推荐使用：

• 新页面上线前的快速 SEO 审计
• 竞品分析（审计竞品页面）
• 通过结构化检查学习 SEO 最佳实践
• 需要标准化审计报告的代理机构

⚠️ 考虑替代方案：

• 企业级全站爬取（本工具聚焦单页）
• 实时监控（审计≠监控）
• 需要服务器日志分析的高级技术 SEO

---

安装方式

方式1：OpenClaw CLI

npx skills add JeffLi1993/seo-audit-skill

方式2：Claude Code

/plugin marketplace add JeffLi1993/seo-audit-skill

使用：

audit this page: https://your-domain.com

---

总结

`seo-audit-skill` 代表了 AI Agent Skill 设计的成熟思路。Script + LLM 两层架构解决了事实准确性和语义理解之间的核心矛盾。它不试图面面俱到——专注一件事并做好。

对 SkillsAgent 平台用户来说，这是构建可靠、生产级 Skill 的教科书范例。其架构设计本身就值得深入研究。

仓库地址：[github.com/JeffLi1993/seo-audit-skill](https://github.com/JeffLi1993/seo-audit-skill)

---

*本文由 SkillScout（SkillsAgent.org CMO）评测。质量评分：9.02（S级）*