SuperAPI AI 工具集

seo-internal-linking

营销与增长

查看项目

更新于 10-16 08:48

技能介绍

用途:审计并改进站内链接拓扑与语义 HTML,帮助搜索引擎和 AI 爬虫理解页面关系;实体 @id 联动参见 references/schema-tier1.md,外链 sameAs 由 M6/seo-entity-linking 负责。

输入:基于 dispatch envelope 中的 PageSnapshot,读取 <run_dir>/pages/<slug>.json(anchors[]、landmarks)与 <run_dir>/crawl.json(graph.edges、pages[].inlinks、templates[]);用 Grep 在 pages/<slug>.html 中查找原文证据;站点工件位于 <run_dir>/site/{robots.json,sitemaps.json,discovery.json}。audit.mjs 已产出的确定性发现列于 findings.deterministic.json,不要重复输出,只补充模型判断的发现。若直接给 URL/路径且无快照,先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs" 并使用打印的快照路径。

审计项:支柱/集群拓扑(区分枢纽与集群页,检查双向链接);正文内链数量(目标约每页 3–5 条描述性内容内链,标记零正文内链页面);锚文本描述性(标记“click here”“read more”等泛化锚文本、裸 URL 与过度精确匹配堆砌);孤立页面(列出无内部入链的 URL);导航与正文链接比例;语义 HTML(<main>、<article>、<nav>、<header>、<footer>、唯一 <h1>、合理标题层级)。

修复:插入内链以 PROPOSED(fixable: proposed)形式给出,含来源页、目标 URL、建议锚文本与挂载句子/选择器,以统一 diff 输出,需逐项接受,因为自动注入可能改变语义或阅读流;语义标签包裹与标题层级修正为 ADVISORY,仅描述不写入。不得编造无法在快照/抓取中观察到的目标 URL、锚文本或拓扑,缺失时询问用户或留 TODO 占位。

验证:每页运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/link-graph.mjs" --snapshot <pages/<slug>.json>(或 --url <u> / --file <path> --base <origin>),返回链接概况;站点拓扑读取 crawl.json;--crawl [--max 25] [--max-depth 3] [--no-robots] [--ua <preset>] 可跑浅层同站抓取并给出潜在孤立页(脚本声明该列表非权威,起始页不计入)。支柱/集群判断需模型在边的数据上完成。全站拓扑/孤立页检查需要站点级抓取,数据不可用时状态为 needs_api,不得虚假通过。

诚实性:固定“每页 3–5 条链接”是可用性/结构启发式而非排名法则,仅作方向性参考;精确匹配堆砌与“链接越多权威越高”是误区。仅在真正有助于读者处建议加链。