关于 internal-link-audit
用于审查网站内链,并将发现的问题整理为标注证据来源的修复计划。它指导通过 Semrush Site Audit 查询或分析用户提供的数据,同时区分工具发现与分析判断。
主要功能
- 01标注证据来源的审计结果
- 02Semrush MCP 报告流程
- 03用户数据备用分析路径
- 04情境相关的内链建议
- 05按优先级排列修复计划
适用场景
- 01查找孤立或内链不足的页面
- 02检查失效链接和重定向
- 03改善抓取深度与锚文本
- 04规划相关主题枢纽与内链
MCP 相关
通过官方 Semrush MCP 获取 Site Audit 项目、快照、问题和页面数据。若无法访问,则可依据用户提供的导出数据、爬虫数据、站点地图或 URL 样本进行分析。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ semrush/ skills --skill internal-link-audit安装后在 Claude Code 中输入/internal-link-audit确认已加载。
详细介绍
内部链接审计
审计网站的内部链接,并制定标注证据来源的修复计划。回答三个问题:
- 哪些重要页面难以通过内部链接到达,或根本无法到达?
- 哪些内部链接已失效、发生重定向、描述性不足,或存在其他效率问题?
- 添加哪些上下文链接和枢纽关系可以让网站架构更清晰?
不要把内部链接当成配额任务。只有当来源页面、目标页面和用户旅程在上下文中相关时,才建议添加链接。
规则来源
在分析和最终输出中,严格区分以下证据类别。
- Semrush 支持的指导原则: 内部链接有助于搜索引擎发现页面、传达层级和上下文,并传递权威性。Semrush 建议使用描述性锚文本、建立相关的枢纽与辐射关系,并通过上下文入站链接为新内容提供支持。
- MCP 合约要求: 以项目数据为依据的发现,只能来自官方 Semrush MCP 返回的报告和字段。产品界面中的功能名称不是 MCP 报告名称。
- 行业启发式方法: 根据业务重要性、潜在用户影响或修复工作量确定优先级,属于分析者的判断,除非有提供的第一方数据作为依据。
- 用户可配置的默认值: 限制、样本量和优先级权重必须根据网站规模、目标和可用数据进行调整。切勿将其视为普遍适用的 SEO 规则。
输入
只询问一次以下信息:
- 根域名;
- 对业务最重要的页面或页面类型;
- 已知的网站迁移、重新设计或架构限制;
- 用户希望进行完整的、以项目数据为依据的审计,还是基于用户提供的导出数据/手动抽样进行审计。
不要要求用户粘贴 Semrush API 密钥。官方 MCP 使用 Semrush 身份验证。
官方 Semrush MCP 工作流
对于尚未明确参数的报告,每次都要先发现工具并获取架构。
- 调用
projects。 - 发现
list_projects,获取其架构,执行该工具,并与用户请求的域名精确匹配。确认siteaudit已激活。 - 调用
site_audit。 - 使用项目 ID 发现并执行
snapshots。选择最新的已完成快照,并保留其snapshot_id和完成日期。 - 执行
info,获取抓取状态、已抓取页面数、问题数、重定向数和抓取深度分布。 - 执行
meta_issues,获取有效的问题 ID 和定义。这只是问题目录,并不能证明网站存在目录中的所有问题。 - 从
info.defects读取当前问题数。对于每个相关且计数非零的问题,使用项目 ID、问题 ID、快照 ID 和受控的数量限制执行issue_details。仅在需要时分页。 - 仅当需要检查某个确切的已抓取 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 会返回自然流量、转化次数、关键词搜索量、锚文本分布或完整的入站链接图谱。
回退方案
使用最可靠的可用数据源,并在输出中注明。
- 已完成 Site Audit 快照的现有 Semrush 项目。
- 用户提供的 Semrush Site Audit 导出数据。
- 爬虫导出数据与站点地图,以及用户提供的 Analytics 或 Search Console 着陆页数据(如有)。
- 站点地图,以及围绕用户重要页面开展的人工抽样。
- 用户提供的 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 网站审核 | 项目和快照 | 完整抓取或已配置的抓取范围 | 日期 | 抓取限制和集成 |
| 用户数据 | 分析数据/导出数据/站点地图 | 说明实际范围 | 日期 | 缺失字段或日期范围 |
| 人工观察 | 已审查的网址 | 抽样 | 日期 | 不代表全站 |
| 模型推断 | 架构/链接建议 | 衍生得出 | 日期 | 需要人工验证 |
然后提供按优先级排序的修复表:
| 优先级 | 问题 | 来源网址 | 目标或受影响的网址 | 证据 | 建议操作 | 置信度 |
|---|
根据观察到的业务重要性、严重程度、影响范围和所需工作量确定优先级。如果用户未提供业务或效果数据,请明确说明,并避免将优先级冒充为预期流量或收入影响。
最后列出:
- 立即修复: 已确认的问题,影响重要页面或导航。
- 后续改进: 有充分依据支持的上下文链接或架构优化机会。
- 先行验证: 基于抽样、推断或依赖集成的发现。
- 无法获取的证据: 审核无法访问的报告或字段。
来源
Semrush 方法论:
主要技术参考: