seo-audit-skill

seo-audit-skill

[English](README.md) · **中文**

可复用的单页面 SEO 审计 Agent Skill。给一个 URL，输出结构化 HTML 审计报告，包含可执行的修复建议。

基于 **Script + LLM 双层架构**：Python 脚本处理确定性检查（HTTP 状态码、XML 解析、字符串匹配），LLM 处理语义判断（关键词意图、内容质量、页面类型推断）。支持 Claude Code、Cursor 及任何兼容 SKILL.md 的 Agent 运行时。

---

报告产出

每次审计生成独立 HTML 报告，保存至 `reports/-audit.html`。

报告章节	内容
Audit Summary	一句话总结 + 关键问题 / 警告 / 通过项一览
Site Checks	可抓取性 · URL 规范化 · i18n · Schema · E-E-A-T
Page Checks	PageSpeed · TDK · H1 · 标题层级 · 字数 · 内链
Priority Actions	影响最大的 3 项修复，按优先级排序
Insight Walkthrough	每个重要发现的 Evidence → Impact → Fix

audit this page: https://openclaw.ai
→ ✅ Report saved → reports/openclaw-ai-audit.html

站点	Audit Summary	Site Checks	Page Checks & insights
colaos.ai reports/colaos-ai-audit.html

---

架构：Script + LLM 双层设计

URL
 │
 ▼
┌──────────────────────────────────────────────────┐
│  Layer 1 · Python 脚本                            │
│  确定性检查 → 结构化 JSON                          │
│                                                  │
│  check-site.py      robots.txt、sitemap (RFC 9309)│
│  check-page.py      H1 / title / meta / canonical│
│  check-schema.py    JSON-LD @type + 字段校验       │
│  check-pagespeed.py PSI API（移动端 + 桌面端）      │
│  fetch-page.py      原始 HTML + SSRF 防护          │
└───────────────────────┬──────────────────────────┘
                        │ JSON + llm_review_required 标志
                        ▼
┌──────────────────────────────────────────────────┐
│  Layer 2 · LLM Agent                             │
│  仅对标记字段进行语义判断                           │
│                                                  │
│  · 关键词意图对齐（H1 / Title）                     │
│  · Meta Description 质量与具体性评分                │
│  · 页面类型 → 期望 Schema @type 映射               │
│  · E-E-A-T 信任页面可达性（footer/nav 链接）         │
│  · 内容分析（字数、标题层级、内链）                   │
└───────────────────────┬──────────────────────────┘
                        │
                        ▼
              report-template.html
              → reports/-audit.html

**为什么分两层？** 脚本处理 80% 的确定性检查——robots.txt 是否存在？Title 是否 55 个字符？LLM 处理 20% 需要理解力的判断——这个 H1 在语义上是否覆盖了"AI workflow automation"的搜索意图？`llm_review_required` 标志确保 LLM 仅在脚本明确无法判断时才介入——事实性检查不会产生幻觉，语义性检查不会有盲区。

---

Skill 说明

Skill	层级	适用场景
seo-audit	Basic	默认入口 — 给一个 URL，20+ 项结构化检查
seo-audit-full	Full	深度审计：Core Web Vitals、内容质量评分、GSC 数据、竞品差距分析

---

审计覆盖范围

站点级检查

检查项	检查内容	Basic	Full
robots.txt	RFC 9309 指令组解析、Allow/Disallow 逻辑、Googlebot 状态、Sitemap 指令	✅	✅
sitemap.xml	有效 XML、URL 数量、追踪 robots.txt 声明的 Sitemap 路径	✅	✅
404 处理	真 404 vs 软 404（200）vs 跳转首页（301）	✅	✅
URL 规范化	HTTP→HTTPS