SuperAPI AI 工具集

seo-headings-structure

营销与增长

查看项目

更新于 10-15 22:11

技能介绍

用途:审计并修复页面的标题层级与语义大纲,使页面结构对搜索引擎和 AI 引擎可读,便于提取答案块与理解内容范围。

主要能力:检查每页是否恰好一个 H1(零个或多个均为问题);检查 H2-H6 是否逐级下降、无跳级;检查标题文本是否具描述性,标记空标题、纯样式标题和“Section 1”类占位符;检测 main、article、section、nav、header、footer 等地标,标记标题位于无语义 div 中或存在多个 main 的情况;检查大纲与地标是否一致,孤立地标或地标外标题均记为问题。

使用方式:基于 dispatch envelope 指定的 PageSnapshot,从 <run_dir>/pages/<slug>.json 读取 headings[] 与 landmarks,用 Grep 在 pages/<slug>.html 中取证;站点产物位于 <run_dir>/site/。audit.mjs 已产出的确定性发现列于 findings.deterministic.json,不重复输出,只补充模型判断的发现。若直接传入 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 <u> / --file <path>),返回 headings 块(各级计数、h1_count、skipped_levels)。

修复:标题层级重构为 proposed,需逐项接受,输出 fix_preview diff,不自动写入;缺失 H1 时从 title/og:title 或明显页面标题元素提议,逐项接受,来源不明时询问用户,不得凭空编造;语义地标包裹为 advisory,工具不写入。

限制:多个 H1 在 HTML5 中合法,现代解析器与 AI 可容忍,按 severity 3 方向性处理,非严重失败;跳级主要影响可访问性与结构,影响应如实表述为方向性,不承诺排名提升;标题关键词堆砌无助于排名,不应建议堆词。渲染 DOM 层不可用且标题为客户端注入时,状态为 needs_api,不得误判通过。