SEO 快速审核(轻量版)
运行 scripts/audit.mjs 检查用户提供的本地 HTML 文件,并报告核心页面内 SEO 检查项的通过/警告/失败状态。完全离线——脚本读取一个文件并输出 JSON。
范围与规则
- 仅审核用户提供的文件。此轻量版不会获取 URL、robots.txt 或 sitemap.xml——在报告中需说明这一点。
- 通过/失败基于常见约定,而非搜索引擎保证。
- 绝不修改文件。只读。
1. 运行
需要 Node 18+,零依赖。
node <skill-dir>/scripts/audit.mjs page.html
JSON 输出到 stdout;当存在任何警告或失败时退出码为 1(可用于 CI 流水线),读取或使用错误时退出码为 2。
2. 读取报告
summary:通过/警告/失败/信息计数。checks[]:包含{id, status, detail}的数组,检查项包括:title、meta-description、canonical、robots-meta、viewport、open-graph、h1、img-alt、lang、charset。
3. 修复指南
title/meta-description警告 → 重写为约 30-65 / 50-160 个字符。robots-meta: noindex出现在需要排名的页面上 → 移除该指令。canonical缺失 → 添加<link rel="canonical">。h1失败 → 每页恰好一个描述性的 h1。open-graph警告 → 为链接预览添加 og:title/og:description/og:image。
轻量版 vs 完整版
完整版 seo-quick-audit 额外支持抓取在线 URL,包括 /robots.txt 和 /sitemap.xml 状态、twitter-card 检查以及重定向处理。