internal-link-builder

内部链接构建器

版本： 1.2.0 更新日期： 2026-06-30 最新更新： v1.2.0 会在修改链接前使用 respira_get_snapshot 对每个页面进行快照，使用 respira_find_element 定位确切的目标段落，并在该处使用 respira_update_element 插入上下文链接，而不是重写整个页面；通过 respira_batch_update 一次性在多个页面上应用链接；并使用 respira_get_option / respira_update_option 持久化每个站点的链接策略（锚文本规则、已构建的主题集群、禁止链接的页面组合），让后续运行能够基于之前的工作继续构建。

为 WordPress 站点进行策略性内部链接构建。分析所有已发布的内容，梳理主题关系，找出页面之间高价值的链接机会，并在进行任何更改前提供清晰的计划供你批准。只要有人提到内部链接、链接构建、内容互链、需要添加链接的孤立页面、主题集群、支柱页面，或希望改善网站的 SEO 内部链接结构，就使用此技能。

此技能的作用

内部链接是最具影响力的页面 SEO 策略之一——它们可以传递页面权重、帮助搜索引擎了解网站结构，并引导访客查看相关内容。大多数 WordPress 站点的内部链接都严重不足，白白浪费了许多价值。

此技能会读取每个已发布的页面和文章，构建内容关系图，并找出通过上下文链接连接相关内容的自然机会。在修改任何内容之前，它都会先向你展示完整计划。

查找：

• 孤立内容（没有入站内部链接或入站链接很少的页面／文章）
• 应当链接到相关子页面却没有这样做的中心页面
• 提及其他页面所涵盖主题却没有添加链接的博客文章
• 支柱／集群机会（主题相关、应当相互链接的内容）
• 具有较高权威潜力、却没有传递链接权益的页面
• 链接过多的页面（过多的出站链接会稀释价值）
• 缺少上下文链接的内容（提及主题却没有添加相应链接）

建议：

• 具体的来源页面 → 目标页面链接组合
• 建议的锚文本（自然、描述性强，避免堆砌关键词）
• 链接位置的上下文（链接应位于哪个段落／部分）
• 优先级排序（高／中／低影响）
• 每条建议的理由（解释为何该链接合理）

要求

• 已安装并连接 Respira for WordPress 插件
• MCP 连接处于活动状态（桌面端或 WebMCP）
• 具有读取权限，以扫描站点内容
• 具有写入权限，以创建副本（仅在用户批准更改后）

触发短语

• “构建内部链接”

其他触发词

• “改善内部链接”
• “查找内部链接机会”
• “让我的内容互相链接”
• “修复孤立页面”
• “创建主题集群”
• “将我的页面链接起来”
• “内部链接审计”

执行工作流

阶段 1：内容清点与映射

1. 通过 respira_get_site_context 验证 Respira + MCP 连接。如果不可用，请停止并显示设置指南。
2. 通过 respira_get_option（键 respira_internal_link_strategy）加载此站点已保存的链接策略（如有）。其中包含之前运行时采用的锚文本规范、已建立的主题集群以及禁止链接的配对。使用该策略，让重复运行能够扩展之前的工作，而不是重复提出相同的链接。如果不存在，则从头开始，并在阶段 4 将其写回。
3. 获取所有已发布内容：
   • respira_list_pages — 获取所有页面
   • respira_list_posts — 获取所有文章
4. 加载每个内容条目的完整内容：
   • respira_read_page 或 respira_read_post
   • 提取：标题、URL/slug、标题层级、主要主题、现有内部链接、字数
5. 构建一份内容映射——结构化索引，包含：
   • 每个页面/文章的主要主题和子主题
   • 每篇内容所针对的关键词和短语
   • 现有内部链接（来源 → 目标配对）
   • 每个页面的入站链接数量
   • 内容类型（支柱页面、博客文章、产品页面、着陆页等）

阶段 2：机会分析

分析内容映射，找出链接机会。对每个潜在链接进行评估：

1. 主题相关性——来源内容是否与目标自然相关？仅推荐对读者确实有帮助的链接。链接应当像是一个有益的“了解更多”时刻，而不是生硬的 SEO 操作。

2. 上下文契合度——来源内容中是否有适合放置链接的自然位置？请留意：

   • 提到了目标页面的主题，但尚未添加链接
   • 讨论相关概念的段落
   • 可自然补充目标页面的列表或资源部分
   • 提及更广泛主题的引言或结论

3. 链接权益价值——请考虑：

   • 孤立页面（0-1 个入站链接）应优先作为目标
   • 高流量/高权威页面是有价值的来源
   • 难以通过导航访问的深层页面最能从中受益
   • 不要给单个页面添加过多链接（每页新增约 3-5 个链接后，收益会递减）

4. 锚文本质量——建议的锚文本应：

   • 在上下文中读起来自然
   • 描述读者将看到的内容（而不是“点击这里”）
   • 使用相关关键词，但避免垃圾信息式写法
   • 针对同一目标使用不同的表述

阶段 3：呈现计划

将链接计划整理成清晰、便于浏览的报告。按优先级对建议分组：

## Internal Link Building Plan

### Site Overview
- Total pages/posts scanned: X
- Existing internal links found: X
- Orphaned content (0-1 inbound links): X
- New links recommended: X

### High Priority (orphaned pages & pillar connections)

1. **[Source Page Title]** → **[Target Page Title]**
   - Why: [Brief reasoning — e.g., "Source discusses WordPress security but doesn't link to your dedicated security guide"]
   - Anchor text: "[suggested anchor text]"
   - Placement: [Where in the source content — e.g., "In the paragraph about plugin vulnerabilities (under H2 'Keeping Your Site Safe')"]

2. ...

### Medium Priority (topical cluster links)
...

### Low Priority (nice-to-have contextual links)
...

### Summary
- High priority: X links (strongly recommended)
- Medium priority: X links (good for SEO)
- Low priority: X links (optional enhancement)

然后询问：

以下是内部链接计划。您希望我：

1. 应用所有建议（会创建副本供审核）
2. 仅应用高优先级链接
3. 由您选择要应用的具体链接
4. 仅将此计划作为参考——不做任何更改

继续之前，请等待明确确认。

阶段 4：应用链接（仅在获批后）

1. 编辑前，使用 respira_get_snapshot 为即将修改的页面创建快照。一个快照即可覆盖本次操作，并可通过 respira_restore_snapshot 一步撤销整个修改过程。在常见情况下，这取代了旧的先复制再编辑流程：直接原位编辑，以快照作为安全保障。（如果用户明确希望先创建并排草稿以供审核，再发布，仍可选择使用 respira_create_page_duplicate / respira_create_post_duplicate 先复制。）
2. 对每个获批的链接，找到确切的插入位置，而不是重写页面：
   • 使用 respira_find_element 定位应插入链接的目标段落或区块（根据计划中“Placement”备注所记录的周边文本或标题进行匹配）
   • 使用 respira_update_element 仅修改该元素，在匹配文本中内联插入 <a href="...">anchor text</a>。这样页面的其余部分将保持字节级不变。
   • 遵循页面构建器的格式（Gutenberg 区块、Divi 短代码、Elementor 数据等）。对于复杂的结构情况，先使用 respira_extract_builder_content 了解节点树。
3. 如果一次操作要为许多页面添加链接，请使用 respira_batch_update 一次性处理，而不是逐页单独写入。根据获批计划构建编辑列表（页面 / 文章 ID + 元素目标 + 新标记），并一并提交。仅对零星插入使用单独的 respira_update_element / respira_update_page / respira_update_post 调用。
4. 完成所有编辑后，提供摘要：
   • 修改的页面数量
   • 添加的链接总数
   • 用于回滚的快照 ID，以及在 WordPress 管理后台查看已修改页面的链接
5. 使用 respira_update_option 持久化更新后的链接策略（键 respira_internal_link_strategy）：记录现已建立的内容集群、使用的锚文本规范，以及任何禁止链接的页面组合，以便下次运行从此状态开始。

链接质量规则

这些规则可避免此技能提出有害或垃圾内容式的建议：

• 相关性优先——绝不要仅为 SEO 机制而推荐链接。每个链接都必须真正有助于读者在两个页面之间浏览。
• 禁止自链接——不要将页面链接到自身。
• 禁止重复链接——不要推荐源页面上已存在的链接。
• 尊重现有链接——如果某个段落已有 2 个或更多链接，就不要再添加。链接密度会影响可读性。
• 锚文本自然——不要堆砌完全匹配的关键词。锚文本应自然融入句子。
• 考虑构建器格式——插入链接时，保留页面构建器的内容格式。不要破坏 Divi 短代码、Elementor JSON 或 Gutenberg 区块标记。
• 默认采取保守策略——如果无法确定链接是否相关，就不要添加。推荐 10 个优质链接，胜过 30 个平庸链接。

输出格式

始终包括：

1. 站点内容摘要（已扫描的页面 / 文章、现有链接密度）
2. 内容地图要点（识别出的主题集群、发现的孤立内容）
3. 优先级链接计划（高 / 中 / 低优先级，并说明各自的理由）
4. 明确的确认提示——未经批准，绝不继续
5. 影响预估（哪些孤立页面将得到补充，哪些集群将得到加强）

如果已应用更改，还应包括：

6. 更改摘要（修改的页面、添加的链接、快照 ID）
7. 审核说明（应在 WordPress 中审核哪些页面，以及如何回滚）

安全模型

• 先进行只读分析——在进行任何更改之前扫描全部内容
• 任何编辑前都要获得用户明确确认
• 写入前创建快照——respira_get_snapshot 会先捕获页面，因此可通过 respira_restore_snapshot 一步还原整个操作
• 精准编辑——respira_find_element + respira_update_element 只修改匹配的段落，不影响页面其余内容（不会重写整页）
• 用户想要并排草稿而非原地编辑时，仍可先创建副本
• 提供回滚指导（如果不需要，可恢复快照）
• 保留所有现有内容和链接——只添加，不删除

免责声明

此技能会识别内部链接机会，并创建优化后的副本供审核。

它无法：

• 保证排名提升
• 修复外部链接／反向链接情况
• 取代完善的内容策略
• 未经审核就发布更改

它可以：

• 找出你遗漏的真实内容关联
• 让被埋没的孤立页面重新获得关注
• 通过上下文链接强化主题集群
• 节省数小时的手动内容审查时间

工具

WordPress 核心工具

• respira_get_site_context
• respira_list_pages
• respira_list_posts
• respira_read_page
• respira_read_post
• respira_extract_builder_content
• respira_inject_builder_content
• respira_create_page_duplicate
• respira_create_post_duplicate
• respira_update_page
• respira_update_post

定向插入（链接编辑首选方式）

• respira_find_element — 定位用于上下文插入的确切目标段落／区块
• respira_update_element — 仅在该元素中插入链接，不重写整页
• respira_batch_update — 一次性在多个页面中应用链接

快照与回滚

• respira_get_snapshot — 在编辑前捕获页面
• respira_restore_snapshot — 一步还原

按站点保存策略

• respira_get_option — 加载已保存的链接策略（respira_internal_link_strategy）
• respira_update_option — 保存已构建的集群、锚文本规则和禁止链接的配对项

遥测

运行完成后，向以下地址发送即发即弃的使用情况跟踪信息：

• POST https://www.respira.press/api/skills/track-usage

包含：

• skill_slug = internal-link-builder
• 站点／版本上下文
• 耗时和成功状态
• 已扫描页面、推荐链接和已应用链接的数量
• 使用的工具

遥测失败时，绝不要阻塞用户流程。

相关技能

• SEO 与 AEO 增强器（与此技能互补——先运行 SEO 审核，再构建链接）
• WordPress 站点 DNA（建立链接前先了解站点结构）
• 技术债务审计

---

由 Respira 团队构建 https://respira.press/skills/internal-link-builder