mcpField
I
internal-link-audit

internal-link-audit

github.com/semrush营销与增长1278 次安装1 周前更新
代码仓库

关于 internal-link-audit

用于审查网站内链,并将发现的问题整理为标注证据来源的修复计划。它指导通过 Semrush Site Audit 查询或分析用户提供的数据,同时区分工具发现与分析判断。

主要功能

  1. 01标注证据来源的审计结果
  2. 02Semrush MCP 报告流程
  3. 03用户数据备用分析路径
  4. 04情境相关的内链建议
  5. 05按优先级排列修复计划

适用场景

  1. 01查找孤立或内链不足的页面
  2. 02检查失效链接和重定向
  3. 03改善抓取深度与锚文本
  4. 04规划相关主题枢纽与内链

MCP 相关

通过官方 Semrush MCP 获取 Site Audit 项目、快照、问题和页面数据。若无法访问,则可依据用户提供的导出数据、爬虫数据、站点地图或 URL 样本进行分析。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/semrush/skills --skill internal-link-audit

安装后在 Claude Code 中输入/internal-link-audit确认已加载。

详细介绍

内部链接审计

审计网站的内部链接,并制定标注证据来源的修复计划。回答三个问题:

  1. 哪些重要页面难以通过内部链接到达,或根本无法到达?
  2. 哪些内部链接已失效、发生重定向、描述性不足,或存在其他效率问题?
  3. 添加哪些上下文链接和枢纽关系可以让网站架构更清晰?

不要把内部链接当成配额任务。只有当来源页面、目标页面和用户旅程在上下文中相关时,才建议添加链接。

规则来源

在分析和最终输出中,严格区分以下证据类别。

  • Semrush 支持的指导原则: 内部链接有助于搜索引擎发现页面、传达层级和上下文,并传递权威性。Semrush 建议使用描述性锚文本、建立相关的枢纽与辐射关系,并通过上下文入站链接为新内容提供支持。
  • MCP 合约要求: 以项目数据为依据的发现,只能来自官方 Semrush MCP 返回的报告和字段。产品界面中的功能名称不是 MCP 报告名称。
  • 行业启发式方法: 根据业务重要性、潜在用户影响或修复工作量确定优先级,属于分析者的判断,除非有提供的第一方数据作为依据。
  • 用户可配置的默认值: 限制、样本量和优先级权重必须根据网站规模、目标和可用数据进行调整。切勿将其视为普遍适用的 SEO 规则。

输入

只询问一次以下信息:

  • 根域名;
  • 对业务最重要的页面或页面类型;
  • 已知的网站迁移、重新设计或架构限制;
  • 用户希望进行完整的、以项目数据为依据的审计,还是基于用户提供的导出数据/手动抽样进行审计。

不要要求用户粘贴 Semrush API 密钥。官方 MCP 使用 Semrush 身份验证。

官方 Semrush MCP 工作流

对于尚未明确参数的报告,每次都要先发现工具并获取架构。

  1. 调用 projects。
  2. 发现 list_projects,获取其架构,执行该工具,并与用户请求的域名精确匹配。确认 siteaudit 已激活。
  3. 调用 site_audit。
  4. 使用项目 ID 发现并执行 snapshots。选择最新的已完成快照,并保留其 snapshot_id 和完成日期。
  5. 执行 info,获取抓取状态、已抓取页面数、问题数、重定向数和抓取深度分布。
  6. 执行 meta_issues,获取有效的问题 ID 和定义。这只是问题目录,并不能证明网站存在目录中的所有问题。
  7. 从 info.defects 读取当前问题数。对于每个相关且计数非零的问题,使用项目 ID、问题 ID、快照 ID 和受控的数量限制执行 issue_details。仅在需要时分页。
  8. 仅当需要检查某个确切的已抓取 URL 时,才使用 page_list,然后使用 page_info。

经测试的公开 MCP 提供基于问题的 Site Audit 报告,而非名为 Internal Linking thematic report 的报告。实时合约测试期间发现的相关问题 ID 包括:内部链接失效、孤立的站点地图/Google Analytics 页面、页面抓取深度、仅有一个内部链接的页面、重定向链、永久和临时重定向、nofollow 内部链接、没有锚文本的链接,以及描述性不足的锚文本。始终重新发现实时目录,不要将这些 ID 硬编码为永久合约。

Projects 访问权限为只读。切勿承诺创建项目、更改抓取设置、连接 Analytics 或运行新审计。如果没有匹配的项目或已完成的快照,请说明这一限制,并使用备用方案层级。

访问与证据方面的注意事项

  • 执行前告知用户,Semrush 查询可能会消耗 API 单位。先使用足以确认问题的最小结果集,再根据用户需要扩展结果,以获取完整条目。
  • issue_details 返回空结果,表示所选快照中没有返回该问题的发生记录。不要将其视为工具故障,也不要虚构示例。
  • 项目缺失、Site Audit 工具未启用、快照缺失、字段不可用或执行出错,只会使相应的数据分支无法继续。说明哪些内容无法确认。
  • 不要仅凭样本、站点地图或用户手动提供的 URL 列表推断全站覆盖情况。
  • 除非实际执行的报告包含相关字段,否则不要声称 Site Audit 会返回自然流量、转化次数、关键词搜索量、锚文本分布或完整的入站链接图谱。

回退方案

使用最可靠的可用数据源,并在输出中注明。

  1. 已完成 Site Audit 快照的现有 Semrush 项目。
  2. 用户提供的 Semrush Site Audit 导出数据。
  3. 爬虫导出数据与站点地图,以及用户提供的 Analytics 或 Search Console 着陆页数据(如有)。
  4. 站点地图,以及围绕用户重要页面开展的人工抽样。
  5. 用户提供的 URL 列表。

如果提供的数据无法证明确实覆盖全站,则将第 3–5 级标注为抽样数据。

工作流程

1. 确定覆盖范围与架构

记录:

  • 域名和所选快照日期;
  • 审核状态和已抓取的页面数;
  • 可用的深度分布;
  • 用户提供的重要页面;
  • 数据来源和覆盖范围限制。

只能根据已观察到的导航、URL、站点地图或用户提供的文档推断架构。分布平坦本身并不能证明搜索引擎无法理解该网站。

2. 查找孤立页面或内链不足的页面

孤立页面是指在用于识别它的数据集中,没有可抓取的入站内链的页面。Site Audit 可能会根据站点地图或已关联的 Analytics 数据,提供不同的孤立页面问题;报告时注明数据来源,因为两者涵盖的页面集合不同。

对于每个返回的 URL,判断页面是否应该:

  • 从上下文相关的页面或合适的枢纽页添加链接;
  • 与当前的对应页面合并,或重定向到该页面;
  • 有意排除在搜索之外;或
  • 在审核内容、流量、转化和反向链接后移除。

Semrush 的编辑指南建议发布新内容时,争取获得两到三个上下文相关的入站链接。应将此视为编辑目标,而不是适用于所有现有 URL 的自动失败门槛,也不是排名提升的保证。

除非第一方数据或实际执行的 Semrush 数据确实能证明其流量,否则不要将某页面称为高流量孤立页面。

3. 检查失效链接和重定向

对于 issue_details 返回的每条记录,保留来源 URL、目标 URL(如有)、HTTP 状态码或问题信息(如有)、问题 ID 和快照日期。

建议采取以下一种做法:

  • 将来源页面中的链接更新为正确且可访问的目标页面;
  • 如果存在真正的替代页面,且更广泛的入站引用足以证明有必要,则重定向过时的目标页面;
  • 如果没有有用的目标页面,则移除链接;
  • 如果内链经过了可避免的重定向链,则将其更新为指向最终 URL。

永久迁移使用 301 或 308,临时迁移使用 302 或 307。不要声称临时重定向必然无法传递链接权重。

4. 检查抓取深度

使用 info.depths 查看分布,并结合 info.defects 中当前的深度问题以及 issue_details 查找受影响的 URL。Semrush Site Audit 可能会标记需要点击超过三次才能访问的页面,但这只是产品检查标准,并非普遍适用的排名规律。

当用户指出某页面很重要,或用户提供的第一方证据表明该页面具有显著需求或业务价值时,优先调整其深度。不要设定关键词搜索量门槛,也不要要求每个重要页面都必须从首页链接。

5. 检查锚文本和 nofollow 问题

对于当前仍存在的缺失锚文本、描述性不足的锚文本和内部 nofollow 链接问题,请参考发现的问题。

  • 优先使用简洁且能以自然语言描述目标页面的锚文本。
  • 如果描述性短语能帮助用户了解目标页面,请避免使用“点击此处”等笼统文本。
  • 不要仅仅因为锚文本与目标页面完全匹配就将其标记为问题。请结合重复情况、上下文和可读性进行审查。
  • 如果数据源未提供相关信息,请勿声称已掌握某个目标页面的完整锚文本分布。
  • 逐个审查内部 nofollow 链接。不要声称该属性会绝对阻止所有权重传递,也不要自动要求移除该属性。
6. 推荐上下文中心页和链接

根据观察到的主题关系、导航结构和提供的内容数据,识别中心页与辐射页的关联机会。中心页应围绕对用户有意义的主题组织内容,而不应仅仅是内部链接数量最多的网址。

对于每条建议的链接,请列出:

  • 来源网址;
  • 目标网址;
  • 这种关联的用途;
  • 描述性锚文本建议;
  • 证据来源;
  • 置信度。

不要要求固定数量的同级链接、每个中心页都链接到首页,或每个主题集群都新建支柱页面。

输出

首先提供证据摘要:

证据类别来源覆盖范围快照或日期局限性
Semrush 网站审核项目和快照完整抓取或已配置的抓取范围日期抓取限制和集成
用户数据分析数据/导出数据/站点地图说明实际范围日期缺失字段或日期范围
人工观察已审查的网址抽样日期不代表全站
模型推断架构/链接建议衍生得出日期需要人工验证

然后提供按优先级排序的修复表:

优先级问题来源网址目标或受影响的网址证据建议操作置信度

根据观察到的业务重要性、严重程度、影响范围和所需工作量确定优先级。如果用户未提供业务或效果数据,请明确说明,并避免将优先级冒充为预期流量或收入影响。

最后列出:

  1. 立即修复: 已确认的问题,影响重要页面或导航。
  2. 后续改进: 有充分依据支持的上下文链接或架构优化机会。
  3. 先行验证: 基于抽样、推断或依赖集成的发现。
  4. 无法获取的证据: 审核无法访问的报告或字段。

来源

Semrush 方法论:

主要技术参考:

评论

支持 Markdown