1. 项目定位与用途
seo-audit-skill 是为 AI Agent（如 Claude Code、Cursor）设计的可复用 SEO 审计技能插件。其核心用途是接收一个 URL，自动执行全面的 SEO 检查，并生成结构化的 HTML 审计报告，报告包含审计摘要、站点级检查、页面级检查、优先级行动项和详细洞察 walkthrough。该技能旨在将 SEO 审计流程标准化、自动化，使开发者、SEO 专员和内容创作者能够快速评估网页的 SEO 健康度并获得可操作的修复建议。
项目档案插件 / 扩展
JeffLi1993/seo-audit-skill 插件：用途、安装与配置说明
JeffLi1993/seo-audit-skill：seo-audit-skill 是为 AI Agent（Claude Code、Cursor）设计的可复用 SEO 审计技能，通过 Python本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
seo-audit-skill 是为 AI Agent（Claude Code、Cursor）设计的可复用 SEO 审计技能，通过 Python 脚本与 LLM 双层架构自动化执行 20+ 项检查，快速生成包含可执行建议的结构化 HTML 报告，帮助开发者与 SEO 专员高效优化网页。
中文项目介绍
seo-audit-skill 是一个专为 AI Agent（如 Claude Code、Cursor）设计的可复用 SEO 审计技能插件。它允许用户通过简单指令对任意 URL 进行单页面 SEO 审计，并输出结构化 HTML 报告，其中包含审计摘要、站点/页面检查结果、优先级修复建议和详细洞察。
该项目解决了人工进行 SEO 审计耗时、易遗漏关键项且难以标准化的问题。通过自动化脚本执行确定性检查（如 HTTP 状态、XML 解析、字符串匹配），并利用 LLM 进行语义判断（如关键词意图、内容质量），实现了高效、准确的审计流程。
适用场景包括：在 AI 编码助手中即时检查网页 SEO 健康度；开发团队在 CI/CD 流程中集成审计以确保新页面符合规范；SEO 专员使用完整 tier 进行深度技术审计；内容营销团队批量审计重要页面并获取优先级清单。
技术特征上，项目采用 Script + LLM 双层架构：Python 脚本层负责事实性检查（robots.txt、sitemap、TDK、PageSpeed 等），LLM 层处理语义分析（页面类型推断、E-E-A-T 评估）。审计结果保存为独立 HTML 文件，并提供基础（seo-audit）与完整（seo-audit-full）两个 tier，覆盖从基础规范到 Core Web Vitals 的 20+ 项指标。
详细信息与使用说明
2. 解决的问题
传统的 SEO 审计依赖人工逐项检查，过程繁琐且容易遗漏关键指标，同时不同审计人员的标准不一，导致结果难以复现和对比。seo-audit-skill 通过将审计流程分解为脚本执行的确定性检查和 LLM 处理的语义分析，实现了自动化、一致性的审计，显著提升效率并减少人为错误，同时输出标准化报告便于追踪和协作。
3. 适用场景
seo-audit-skill 适用于多种场景：一是日常开发中，在 AI 编码助手（如 Claude Code、Cursor）里快速检查网页 SEO 表现；二是持续集成流程，将审计作为质量门禁，确保上线页面满足基础规范；三是专业 SEO 分析，使用完整 tier 深入评估 Core Web Vitals、搜索控制台数据和内容质量；四是内容运营，批量审计关键页面并优先处理高影响问题。其自动化特性使其成为技术团队和营销团队的实用工具。
4. 安装方式
安装 seo-audit-skill 需要将 seo-audit-skill 目录部署至支持 SKILL.md 的 Agent 运行时（如 Claude Code、Cursor）的技能目录中，并确保运行环境具备 Python 3.x 以执行脚本层检查。具体依赖的 Python 包在仓库中未明确给出，可能需要根据脚本导入的模块（如 requests）自行安装。无需额外配置，但需保证网络访问权限以调用 PageSpeed Insights API。
5. 使用方式
使用 seo-audit-skill 非常简单：在兼容 SKILL.md 的 AI Agent 运行时中，直接输入自然语言指令即可触发审计。基础审计使用类似 'audit this page: https://example.com' 的指令，调用 seo-audit 技能；完整审计则使用 'do a full SEO audit for https://example.com' 调用 seo-audit-full。审计过程由 Agent 自动协调 Python 脚本执行检查，并在需要时调用 LLM 进行语义分析。完成后，报告以独立 HTML 文件形式保存到 reports 目录下，文件名基于主机名生成，便于查阅和分享。
6. 实现特点与架构
seo-audit-skill 的实现特点在于其清晰的双层架构分离：底层 Python 脚本（check-site.py、check-page.py、check-schema.py、check-pagespeed.py、fetch-page.py）负责所有事实性、可 deterministic 的检查，确保结果准确无幻觉；上层 LLM 仅对标记字段进行语义分析，如关键词意图匹配、内容质量评分和页面类型推断，从而平衡效率与智能。报告基于 assets/report-template.html 动态生成，结构清晰，包含摘要、检查详情、优先级修复建议和证据链。技能分为基础（seo-audit）和完整（seo-audit-full）两个 tier，用户可根据需求选择，完整 tier 额外覆盖 Core Web Vitals、Google Search Console 状态和竞争对手差距分析。
思维导图
seo-audit-skill
双层架构
Python 脚本层
LLM 语义层
技能 tier
seo-audit (Basic)
seo-audit-full (Full)
报告系统
HTML 模板
reports 目录
审计覆盖
站点级检查
页面级检查
常见问题
seo-audit-skill 是什么？
seo-audit-skill 是为 Claude Code、Cursor 等 AI Agent 运行时设计的可复用 SEO 审计技能插件，通过 Python 脚本与 LLM 协作，对单页面执行自动化检查并生成结构化 HTML 报告。
如何安装 seo-audit-skill？
将 seo-audit-skill 目录复制到支持 SKILL.md 的 Agent 运行时（如 Claude Code、Cursor）的技能目录中，并确保系统已安装 Python 3.x。具体 Python 依赖包未在仓库中明确列出，可能需要根据脚本导入的模块（如 requests）自行安装。
如何使用 seo-audit-skill 进行审计？
在 Agent 运行时中使用自然语言指令触发：基础审计用 'audit this page: URL' 调用 seo-audit；完整审计用 'do a full SEO audit for URL' 调用 seo-audit-full。审计完成后，报告自动保存至 reports/<hostname>-audit.html。
seo-audit-skill 支持哪些审计项目？
基础 tier（seo-audit）覆盖 20+ 项检查，包括 robots.txt、sitemap、URL 规范化、TDK、H1、PageSpeed 等；完整 tier（seo-audit-full）额外提供 Core Web Vitals、GSC 爬取状态、内容质量分析、社交标签等深度指标。
审计报告包含哪些内容？
报告为独立 HTML 文件，包含审计摘要（一句话结论与状态概览）、站点检查（可抓取性、i18n、Schema 等）、页面检查（TDK、 headings、内链等）、优先级行动（Top 3 修复建议）和洞察 walkthrough（证据→影响→修复方案）。