用途:针对一个或多个静态 .html 文件(或包含它们的目录)执行页面 SEO 审查,产出可操作的、按严重程度排序的问题清单。触发场景包括“SEO review”“SEO audit”“check SEO on this HTML”“review meta tags on this page”等。
主要能力:内置仅用 Python 标准库的 HTML 解析器,把 SEO 相关信号抽取为单个 JSON 文档;配套完整评分规则与发现报告模板,使每次审查输出保持一致。
使用方式:运行解析器,支持单文件或递归目录(*.html):python3 scripts/extract_seo_signals.py <path> --pretty。输出 JSON 顶层键包括 lang、title、meta、links、scripts、headings、images、links_audit、body_word_count,每个元素带行号便于引用。目录输入输出为 {"files": [...]}。无需 pip install。随后按 references/seo-checklist.md 逐项映射到 JSON 路径,记录严重级别(P0/P1/P2/P3)、行号、逐字引用的标记与修复建议;报告使用 assets/findings-template.md,按严重程度再按文件顺序排列。
限制:不适用于静态站点生成器(Jekyll/Hugo/Astro/Eleventy/Next.js)源码,需要源码感知审查;无法产出 LCP、CLS、INP 等真实性能指标,应改用 Lighthouse 或 PageSpeed Insights;外链、域名权重等站外分析需第三方工具(Ahrefs、SEMrush 等)。若某项检查解析器无法提供信息,不会猜测,会列入报告的范围外事项。