SEO 全站深度审计技能（seo-audit-full）
输入一个页面 URL，即可产出包含 PageSpeed、社交标签与高级技术审查的完整 SEO 审计 HTML 报告。
加分项：脚本内置SSRF防护（阻止私有/回环/保留IP）、API密钥经环境变量或参数提供且错误信息中做密钥脱敏、明确要求先向用户索取PageSpeed密钥、无隐蔽数据外传迹象、User-Agent透明标识。扣分项：密钥通过--api-key命令行参数传递会暴露在进程列表中；无用户对目标URL审计行为的显式确认机制；引用的部分脚本（check-site.py、check-social.py、fetch-page.py）未在证据中出现，无法核实其安全性。
加分项：脚本输出结构化JSON、退出码约定清晰（0/1）、错误分支处理完整（超时、重定向、SSL、配额错误均有可诊断信息）、脚本与文档字段映射一一对应、LLM审查触发标志（llm_review_required）设计自洽。扣分项：check-page.py源码在_slug函数中途截断，无法验证完整性；check-site.py、check-social.py、fetch-page.py、报告模板均未见；无测试套件；静态审读不能证实关键路径可复现。
加分项：触发词列表明确、适用与不适用范围有边界声明（与基础版seo-audit的分工清晰）、输入表格明确可选/必填。扣分项：核心PageSpeed模块完全依赖Google API，对中国大陆网络环境可达性存疑；文档与输出模板全英文，无中文支持声明；判定规则（如E-E-A-T信任页、staging子域名）边界虽细但均为静态承诺，缺乏实测佐证。
加分项：SKILL.md信息架构分层良好（触发条件→输入→架构图→输出→脚本→检查规则→工作流），有版本号2.1和作者标注，仓库声明MIT许可，reference文档补充细则。扣分项：无changelog和更新路径说明，维护责任不明，版本仅见于frontmatter无历史记录，报告模板与部分脚本缺失使分层文档链条不完整。
加分项：工作流分阶段设计合理，脚本JSON到报告占位符的映射规则详细，寻找/影响/修复格式规范，超额价值在于自动化全流程审计。扣分项：静态审读无法验证输出报告可直接使用；最终HTML质量依赖LLM填充质量，未见成品样例；相比直接使用PageSpeed网页版等替代方案，边际价值论证不足。
加分项：核心脚本为可审计的第一手源码，检查规则与阈值（Lighthouse、title长度等）均明示可复核。扣分项：无提交的测试、无CI证据、无第三方执行佐证，声称的脚本产出字段无法静态验证，结论与推断未做来源区分，证据覆盖面有限。
- 本评估为纯静态源码审读，未执行任何脚本，confidence为low。
- 完整审计依赖Google PageSpeed API，中国大陆网络环境下可能不可达，且API密钥需用户自备。
- check-page.py源码在证据中被截断，多个被引用脚本（check-site.py、check-social.py、fetch-page.py）与报告模板未随证据提供，实际可用性未经证实。
- 通过--api-key命令行参数传递密钥可能在多用户环境中泄露，建议优先使用环境变量。
- 发布者未经验证，版本记录与维护承诺不完整，使用前请自行核对最新仓库状态。
这个 Skill 能做什么，适合哪些场景？
seo-audit-full 是 JeffLi1993 的 seo-audit-skill 仓库中针对单个页面的高级 SEO 审计技能。它采用「脚本 + LLM」双层架构：Python 脚本负责 robots.txt、sitemap、JSON-LD、PageSpeed、OG/Twitter 标签等确定性检查，输出结构化 JSON；LLM 只在语义判断（如关键词意图、E-E-A-T 内容质量）时介入。最终报告以独立 HTML 文件保存到 reports/ 目录，按「证据 → 影响 → 修复」格式呈现发现和优先行动清单。运行 PageSpeed 模块前必须提供 Google PageSpeed Insights API 密钥，缺少密钥时技能会主动停止并提示配置。
给定页面 URL（可选提供主关键词），技能分三阶段运行：Phase 1 执行本地核心脚本 check-site.py（robots.txt、sitemap、404、URL 规范化、staging 子域名检测、sitemap 目录清单）、check-page.py（标题、H1、meta 描述、slug、canonical）、fetch-page.py（抓取原始 HTML）和 check-schema.py（JSON-LD 校验）；Phase 2 运行 check-pagespeed.py（Lighthouse 四类分数与 FCP/LCP/TBT/CLS/Speed Index 指标）和 check-social.py（OG 与 Twitter Card 校验）；Phase 3 由 LLM 完成 E-E-A-T 内容质量、重复内容信号和锚文本质量判断。所有结果映射到 assets/report-template.html 模板，保存为 reports/<主机名>-<slug>-full-audit.html，绝不直接向终端打印 HTML。
- 独立站长或营销人员在发布重要落地页前，想要一份包含性能指标、社交分享预览和技术规范的完整体检报告
- SEO 顾问需要对客户页面进行深度技术审计，并生成可直接交付给客户的 HTML 报告
- 内容团队检查新文章是否满足 E-E-A-T 信任页要求（About/Contact/Privacy/Terms 的存在与可达性）
- 开发团队排查 staging/test 子域名是否被公开索引，避免与生产站点竞争排名信号
- 多语言站点验证 hreflang 与本地化 Schema（inLanguage、本地化 URL）是否正确对齐
- 代理商希望批量审计竞品或标杆页面，利用 sitemap 目录清单选取代表性 URL 深入分析
这个 Skill 有哪些优点和局限？
- 脚本 + LLM 双层架构：确定性检查由 Python 完成，LLM 仅在带 llm_review_required 标记的字段上做语义判断，降低幻觉风险
- 覆盖面广：站点级（robots、sitemap 清单、staging 子域名、hreflang）、页面级（TDK、H1、slug、内链）、性能（Lighthouse 四类分数与核心指标）和社交标签
- 输出为独立 HTML 报告并保存到文件，按统一的「证据/影响/修复」格式和优先级行动清单呈现，便于交付
- 对失败模式有明确约定：PageSpeed 超时或配额错误时标记为 error 而非误判为页面性能失败
- MIT 许可，脚本输出全部为结构化 JSON，可直接作为证据核查
- PageSpeed 模块是硬性依赖：没有 API 密钥时完整审计会直接停止，需自行申请 Google API 密钥
- PageSpeed 检查可能耗时约 200 秒，不适合需要快速反馈的场景
- 未提供 GSC、爬取或分析数据时，相关高级模块只能标记为不可用，深度受限
- 仓库 README 未展示测试套件或独立验证结果；兼容平台列表（OpenClaw、Cursor 等）仅为作者声明
- 依赖 pip 安装 requests 和本地 Python 环境，纯浏览器或无 shell 环境无法运行
如何安装这个 Skill？
安装整个技能集合：npx skills add JeffLi1993/seo-audit-skill，或只安装本技能：npx skills add JeffLi1993/seo-audit-skill --skill seo-audit-full。Claude Code 也可用插件方式：/plugin marketplace add JeffLi1993/seo-audit-skill 然后 /plugin install seo-audit-skill。安装后需在技能所在环境执行 pip install requests。源码位于仓库的 seo-audit-full/ 目录，含 SKILL.md、references/REFERENCE.md、assets/report-template.html 和 scripts/。
如何使用这个 Skill？
1) 配置 PageSpeed API 密钥：通过 --api-key 参数或环境变量 PAGESPEED_API_KEY / GOOGLE_PAGESPEED_API_KEY 提供（可在 https://developers.google.com/speed/docs/insights/v5/get-started 免费申请）；2) 在 Claude Code 等代理中输入触发语，如 "full SEO audit"、"advanced SEO audit" 或 "audit this page: https://example.com"（仅 URL 也会触发完整审计）；3) 可推荐提供主关键词以改进内容相关性评分，可选提供原始 HTML、GSC/爬取/分析数据或竞品基准数据；4) 等待技能运行脚本并生成报告，文件位于 reports/<主机名>-<slug>-full-audit.html；5) 技能会询问是否用 open 命令打开报告。注意 PageSpeed 检查最长可能耗时约 200 秒。
这个 Skill 与同类方案有什么区别？
同仓库内的 seo-audit（Basic 层）是直接的对照选项：它不需要 PageSpeed API 密钥、运行约 20+ 项基础检查即可出报告，适合快速体检；而 seo-audit-full 增加了 PageSpeed/Lighthouse、sitemap 目录清单、staging 子域名检测、OG/Twitter 社交标签和 E-E-A-T 内容质量等深度模块，适合需要完整技术审计的场景。