seo-audit-skill

seo-audit-skill 是一款专为 AI 编码代理（如 Claude Code, Cursor）设计的可复用 SEO 审计工具。它采用 “Python 脚本 + LLM”双层架构，结合了确定性代码检查的准确性与大语言模型语义理解的深度，能够针对给定 URL 生成包含可执行修复建议的结构化 HTML 审计报告。

核心架构：确定性 + 语义智能

• Python 脚本层（确定性）：处理 HTTP 状态码、XML 解析、字符串匹配、PageSpeed API 调用等硬性指标，确保数据准确无误。
• LLM 层（语义判断）：处理关键词意图分析、内容质量评估、页面类型推断及 E-E-A-T 深度审查，提供更具洞察力的优化建议。

审计报告产出

每次审计都会生成独立的 HTML 报告，保存至 reports/<hostname>-audit.html。报告包含以下核心章节：

1. Audit Summary：一句话总结 + 关键问题/警告/通过项一览。
2. Site Checks：可抓取性、URL 规范化、i18n、Schema、E-E-A-T 信任页面。
3. Page Checks：PageSpeed 评分、TDK（标题/描述/关键词）、H1 结构、字数、内链分布。
4. Priority Actions：按影响力排序的前 3 项最高优先级修复建议。
5. Insight Walkthrough：针对每个重要发现的“证据 → 影响 → 修复方案”详细拆解。

审计覆盖范围

该 Skill 提供 Basic（基础）和 Full（深度）两种审计层级：

站点级检查 (Site Checks)

页面级检查 (Page Checks)

安装方法

方式一：CLI 安装（推荐）

适用于 Claude Code, Cursor 等支持 npx skills 的环境：

# 安装完整包
npx skills add JeffLi1993/seo-audit-skill

# 或仅安装特定 Skill
npx skills add JeffLi1993/seo-audit-skill --skill seo-audit
npx skills add JeffLi1993/seo-audit-skill --skill seo-audit-full

方式二：Claude Code Plugin

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

使用示例

在 Claude Code 或兼容的 Agent 环境中，直接输入自然语言指令：

1. 基础审计：

audit this page: https://openclaw.ai

输出：✅ Report saved → reports/openclaw-ai-audit.html

2. 深度审计：

deep audit: https://example.com

内置脚本与技术细节

所有 Python 脚本均输出结构化 JSON 到 stdout，退出码 0 表示通过/警告，1 表示存在失败项。

依赖要求：

pip install requests