mcpField
S
seo-backlinks

seo-backlinks

github.com/agricidaniel营销与增长23.3k7.3k 次安装6 天前更新
代码仓库

关于 seo-backlinks

seo-backlinks 是用于 SEO 工作流的反向链接分析技能,帮助营销人员检查链接档案、发现风险并识别竞争对手的链接机会。它会根据可用数据源调整分析内容,并在数据不足时避免给出误导性评分。

主要功能

  1. 01分析链接档案与锚文本
  2. 02评估引用域名质量
  3. 03检测有害链接并建议拒绝
  4. 04比较竞争对手的链接缺口
  5. 05验证已知反向链接状态
  6. 06按数据充分性控制评分

适用场景

  1. 01评估网站反向链接健康状况
  2. 02寻找竞争对手的链接建设机会
  3. 03检查可疑链接是否仍然存在
  4. 04在配置数据源前识别分析限制

MCP 相关

可检测 DataForSEO MCP 是否提供 backlinks_summary 工具,并使用该工具获取反向链接数据。还支持 Moz、Bing Webmaster、Keywords Everywhere、Common Crawl 和验证爬虫等数据源。

安装

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

$npx skills add https://github.com/agricidaniel/claude-seo --skill seo-backlinks

安装后在 Claude Code 中输入/seo-backlinks确认已加载。

附带文件LICENSE.txt

详细介绍

反向链接概况分析

来源检测

分析前,检测可用的数据源:

  1. DataForSEO MCP(付费):检查是否有 backlinks_summary 工具
  2. Moz API(免费注册):"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check moz --json
  3. Bing Webmaster(免费注册):"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check bing --json
  4. Keywords Everywhere(免费注册;提供域名排名和引荐域名数量):"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check keywordseverywhere --json
  5. Common Crawl(始终可用):提供域名级图谱及 PageRank
  6. 验证爬虫(始终可用):检查已知反向链接是否仍然存在

运行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check --json,一次性检测所有来源。

如果除了始终可用的数据源之外,没有配置其他来源:

  • 仍使用 Common Crawl 域名指标生成报告
  • 建议:"运行 /seo backlinks setup,添加免费的 Moz 和 Bing API 密钥以获取更丰富的数据"

快速参考

命令用途
/seo backlinks <url>完整反向链接概况分析(使用所有可用来源)
/seo backlinks gap <url1> <url2>竞争对手反向链接差距分析
/seo backlinks toxic <url>有害链接检测和拒绝建议
/seo backlinks new <url>新增和丢失的反向链接(仅限 DataForSEO)
/seo backlinks verify <url> --links <file>验证已知反向链接是否仍然存在
/seo backlinks setup查看免费反向链接 API 的设置说明

分析框架

生成以下全部 7 个部分。每个部分按优先顺序列出数据来源。

1. 概况

DataForSEO: backlinks_summary → 反向链接总数、引荐域名、域名排名、关注链接比例、趋势。

Moz API: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run moz_api.py metrics <url> --json → 域名权威度、页面权威度、垃圾信息分数、链接根域名、外部链接。

Keywords Everywhere: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run keywordseverywhere_api.py rank <domain> --json → 0-10 Open PageRank(open_page_rank)、全局 rank,以及引荐域名数量(referring_domains),依据当前 API;不提供锚文本或单个链接。Moz 未配置时可将其作为备用数据源;如果两者都可用,则不要用它替代 Moz。

Common Crawl: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run commoncrawl_graph.py <domain> --json → PageRank、调和中心性,以及低置信度的排名/存在情况数据。

评分:

指标良好警告严重
引荐域名>10020-100<20
关注链接比例>60%40-60%<40%
域名多样性单个域名不超过 5%1 个域名超过 10%1 个域名超过 25%
趋势增长或稳定缓慢下降快速下降(>20%/季度)
2. 锚文本分布

DataForSEO: backlinks_anchors

Moz API: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run moz_api.py anchors <url> --json

Bing Webmaster: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run bing_webmaster.py links <url> --json(从链接详情中提取锚文本)

健康分布基准:

锚文本类型目标范围过度优化信号
品牌(公司/域名名称)30-50%<15%
URL/裸链接15-25%不适用
通用(“点击此处”、“了解更多”)10-20%不适用
完全匹配关键词3-10%>15%
部分匹配关键词5-15%>25%
长尾/自然5-15%不适用

如果完全匹配锚文本超过 15%,请将其标记为需要审核;这可能表明存在不自然的模式或链接垃圾信息模式。

3. 引用域名质量

DataForSEO: backlinks_referring_domains

Moz API: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run moz_api.py domains <url> --json → 带 DA 分数的域名

Common Crawl: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run commoncrawl_graph.py <domain> --json → 域名级排名/存在数据,不提供经过验证的引用域名数量

分析:

  • 顶级域名分布:.edu、.gov、.org = 高权威度。过多 .xyz、.info = 低质量
  • 国家/地区分布:与目标市场相符。80% 以上来自无关国家/地区 = PBN 信号
  • 域名排名分布:健康的配置文件会拥有来自各权威度层级的链接
  • 每个域名的 Follow/nofollow:只有 nofollow 链接的网站 = SEO 价值有限
4. 毒性链接检测

DataForSEO: backlinks_bulk_spam_score + 参考资料中的毒性模式

Moz API: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run moz_api.py metrics <url> --json 提供的原始供应商 spam_score(标明数据来源;只有在根据 Moz 当前文档核实后才应用阈值)

验证爬虫: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run verify_backlinks.py --target <url> --links <file> --json(验证可疑链接是否仍然存在)

高风险指标(立即标记):

  • 来自已知 PBN(私人博客网络)域名的链接
  • 不自然的锚文本模式(来自某个域名的链接 100% 使用完全匹配锚文本)
  • 来自受处罚或已从索引中移除的域名的链接
  • 大规模提交到目录(50+ 个目录链接)
  • 链接农场(每页有 10K+ 个出站链接的网站)
  • 付费链接模式(某个域名所有页面中的页脚/侧边栏链接)

中风险指标(手动审核):

  • 来自不相关细分领域的链接
  • 互惠链接模式
  • 来自内容单薄页面(<100 个单词)的链接
  • 来自单个域名的链接过多(来自 1 个域名的反向链接超过 50 个)

加载 ../seo/references/backlink-quality.md,了解完整的 30 种毒性模式和拒绝链接标准。

5. 按反向链接数量排名的热门页面

DataForSEO: backlinks_backlinks,目标类型为 "page"

Moz API: "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run moz_api.py pages <domain> --json

查找:

  • 哪些页面吸引了最多的反向链接
  • 拥有高权威度链接的页面(链接磁石)
  • 没有反向链接的页面(内部链接机会)
  • 拥有反向链接的 404 页面(可通过重定向挽回链接权重)
6. 竞争对手差距分析

DataForSEO: 分别获取两个域名的 backlinks_referring_domains,然后进行比较

Bing Webmaster: 仅当两个站点都已注册,且可由同一个 Bing API 账号访问时,使用 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run bing_webmaster.py compare <url1> <url2> --json 。对于任意竞争对手,请使用 DataForSEO、Moz 或 Common Crawl。

Moz API: 分别对每个域名运行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run moz_api.py metrics <url> --json,比较 DA/PA

输出:

  • 链接到竞争对手但未链接到目标站点的域名 = 链接建设机会
  • 同时链接到双方的域名 = 验证现有关系
  • 仅链接到目标站点的域名 = 竞争优势
  • 20 个最佳链接建设机会及其域名权威度
7. 新增和流失的反向链接

仅 DataForSEO: 使用带日期筛选条件的 backlinks_backlinks,查看 30/60/90 天的变化

验证爬虫: 对已知链接,使用 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run verify_backlinks.py --target <url> --links <file> --json 验证当前状态

注意: 免费来源无法跟踪新增和流失链接的变化。如果用户在未使用 DataForSEO 的情况下请求此部分,请告知用户:“链接增长速度跟踪需要 DataForSEO 扩展。免费来源仅提供特定时间点的快照。”

危险信号:

  • 新链接数量突然激增(可能遭到负面 SEO 攻击)
  • 大量链接突然流失(网站受到处罚或内容被移除)
  • 连续 3+ 个月增长速度下降(内容未能吸引链接)

反向链接健康度评分

计算 0-100 分。混合使用多个来源时,按置信度加权:

因素权重来源(优先级顺序)置信度
引荐域名数量20%DataForSEO > Moz1.0 / 0.85
域名质量分布20%DataForSEO > Moz DA 分布1.0 / 0.85
锚文本自然度15%DataForSEO > Moz > Bing anchors1.0 / 0.85 / 0.70
有害链接比例20%DataForSEO > Moz spam score1.0 / 0.85
链接增长趋势10%仅 DataForSEO1.0
Follow/nofollow 比例5%DataForSEO > Bing details1.0 / 0.70
地理相关性10%DataForSEO > Bing country1.0 / 0.70

**数据充分性门槛:**统计 7 个因素中至少有一个可用数据源的因素数量。

  • **4 个或更多因素有数据:**生成 0-100 的数值评分(按比例重新分配缺失因素的权重)
  • **少于 4 个因素:**不要生成数值评分。改为显示:
    Backlink Health Score: INSUFFICIENT DATA (X/7 factors scored)
    
    显示可用的各项因素评分及其来源和置信度。 建议:"配置 Moz API(免费)以获得可评分的概况。运行 /seo backlinks setup"
不得:为未测量的内容评分

当 Common Crawl 是唯一可用来源时,绝对不得生成任何数值评分——既不能生成健康度评分,也不能生成单项因素评分,更不能给出“近似”或“估算”数值。Common Crawl 仅提供排名和存在情况信号。报告低置信度的排名/存在情况数据,并在所有数字的位置使用字面字符串 Not Assessed。

source: not-assessed 的发现项不得带有数值评分。

当数据源少于 4 个时,数值评分具有误导性:它会让人以为健康度较差,而实际上我们只是缺少数据。

验证门槛(必需,不可省略)

此前已在此技能中说明过这项规则,但仍然遭到违反,因此现在将对其进行检查。在撰写任何反向链接报告前,运行验证器:

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run validate_backlink_report.py --report <report>.json --json

传入你实际收集的数据(cc_data、moz_data、bing_data、dataforseo_data、scoring_factors 和 findings 列表)。当出现以下情况时,source_score_consistency 检查会使报告的 status: FAIL:

  • 存在数值评分,但没有可评分的数据源(Moz、Bing 或 DataForSEO)提供数据——即只有 Common Crawl 的情况;以及
  • 任何标记为 source: not-assessed 的发现项带有数值 score、value 或 health_score。

**如果验证器返回 status: FAIL,不要提交报告。**修正发现项——将违规数值替换为 Not Assessed——然后重新运行验证器,直到通过。

输出格式

反向链接健康度评分:XX/100(或 INSUFFICIENT DATA)
部分状态评分数据来源
概况pass/warn/failXX/100Moz (0.85)
锚文本分布pass/warn/failXX/100Moz (0.85)
引荐域名质量pass/warn/failXX/100CC (0.50)
有害链接pass/warn/failXX/100Moz Spam (0.85)
热门页面infoN/AMoz (0.85)
链接增长趋势pass/warn/failXX/100仅 DataForSEO
严重问题(立即修复)
高优先级(1 个月内修复)
中优先级(持续改进)
链接建设机会(前 10 项)

错误处理

错误原因解决方法
未配置数据源没有 API 密钥,也没有 DataForSEO运行 /seo backlinks setup
Moz 触发速率限制免费套餐:每 10 秒 1 次请求等待 10 秒后重试。脚本已内置此处理。
Bing 网站尚未验证网站未在 Bing 中验证前往 https://www.bing.com/webmasters 验证
CC 下载超时图谱文件较大,连接速度较慢使用 --timeout 180 标志
DataForSEO 不可用未安装扩展运行 ./extensions/dataforseo/install.sh
未返回反向链接数据域名太新或规模太小注意:小型网站的反向链接可能少于 10 个

回退顺序:

  1. DataForSEO 是否可用?→ 将其用作主要数据源(置信度:1.0)
  2. 是否配置了 Moz?→ 用于 DA/PA/垃圾评分/锚文本(置信度:0.85)
  3. 是否配置了 Bing?→ 仅用于已注册资源的链接和对比, 且仅当两个资源都可访问时(置信度:0.70)
  4. 未配置 Moz,但配置了 Keywords Everywhere?→ 用于仅包含排名的 Profile Overview 回退方案(置信度:0.60;单一指标,不含链接数量/锚文本)
  5. 始终:使用 Common Crawl 获取域名级指标(置信度:0.50)
  6. 始终:使用验证爬虫检查已知链接(置信度:0.95)
  7. 全部不可用?→“运行 /seo backlinks setup 配置免费 API”

交付前审查(必须执行)

向用户展示任何反向链接分析之前,必须在内部运行此检查清单。 不要跳过此步骤。展示报告前,先修复发现的所有问题。

核实每一项结论
  • Schema 相关结论:parse_html 是否为每个区块返回了 @type?如果缺少任何 @type, 请重新检查,它可能使用了 @graph 包装(这是有效的 JSON-LD,并非格式错误)。
  • “link_removed” 发现:页面是否由 JS 渲染?如果是 unverifiable_js,请明确说明, 绝不要将 JS 渲染的页面报告为“链接已移除”(这是假阴性)。
  • H1 相关发现:是否有 H1 出现在 h1_suspicious 列表中?如果有,请注明它们可能是 计数器/统计信息,而非语义标题。
  • 互惠链接:如果网站 A 链接到网站 B,且 B 又链接回 A,请标记为 互惠链接模式。将出站链接与已验证的入站来源进行核对。
  • 健康评分:7 项因素中是否有 4 项或更多已评分?如果没有,请报告数据不足, 绝不要展示可能造成误导的数字评分。
核实数据源标签
  • 报告中的每项指标都有数据源标签(例如,“已解析(0.95)”、“CC(0.50)”)
  • 每项“未找到”结果都明确区分“未爬取”“低于阈值”和“错误”
  • 社交媒体页面标记为 unverifiable_js(而非 link_removed)
交叉核对一致性
  • 平台检测结果与实际信号相符(检查是否存在 wp-content、shopify CDN 等)
  • 摘要中的引荐域名数量与已验证链接列表中的实际数量相符
  • 每项结论都有数据源作为依据

如果任何一项检查未通过,请在展示前修正相关发现。绝不要将推断数据当作事实呈现。

分析后

完成任何反向链接分析命令后,始终提供以下选项: “生成专业 PDF 报告?使用 /seo google report”

参考文档

按需加载(启动时不要加载):

  • ${CLAUDE_PLUGIN_ROOT}/skills/seo/references/backlink-quality.md -- 有害链接模式和评分方法详解(共享参考资料,在分析有害链接或垃圾评分时加载)
  • ${CLAUDE_PLUGIN_ROOT}/skills/seo/references/free-backlink-sources.md -- 数据源对比、置信度权重和设置指南(共享参考资料,在配置免费反向链接 API 时加载)

评论

支持 Markdown