用途:审计并生成网页文档 head,即 title、meta description 等头部元素,属于 SEO 检查流程中的 M7 模块。
主要能力:检查 title 是否唯一、长度是否落在共享区间(通过 30-60 字符,推荐 50-60);检查 meta description 是否存在及长度(通过 70-160 字符,推荐 150-160);检查 viewport、charset(utf-8 且位于 head 前 1024 字节内)、html lang(有效 BCP-47)与 robots meta;仅记录 canonical 是否存在,不判定其正确性(该逻辑归 M2)。
使用方式:基于 dispatch envelope 指定的 PageSnapshot,读取 <run_dir>/pages/<slug>.json 与 headers,并用 Grep 在 pages/<slug>.html 中取证。若直接以 URL 或路径调用且无快照,先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs"。验证用 node "${CLAUDE_PLUGIN_ROOT}/scripts/parse-html.mjs" --snapshot <pages/<slug>.json>(或 --url / --file)。
修复策略:AUTO 可补全缺失的 viewport、charset、html lang;PROPOSED 依据 h1、首段与主题生成或裁剪 title 与 description,需逐项接受;ADVISORY 提示用户自行决定是否移除 noindex。内容过薄时留 TODO 占位,不编造。
限制:长度区间是 SERP 展示启发式而非排名因素,超区间只警告不失败;Google 常重写展示标题与描述,不承诺排名收益;meta keywords 已失效,不添加也不推荐;重复 title/description 检查需完整抓取集,单页时报告 needs_api 而非通过。