关于 seo-backlinks
seo-backlinks 是用于 SEO 工作流的反向链接分析技能,帮助营销人员检查链接档案、发现风险并识别竞争对手的链接机会。它会根据可用数据源调整分析内容,并在数据不足时避免给出误导性评分。
主要功能
- 01分析链接档案与锚文本
- 02评估引用域名质量
- 03检测有害链接并建议拒绝
- 04比较竞争对手的链接缺口
- 05验证已知反向链接状态
- 06按数据充分性控制评分
适用场景
- 01评估网站反向链接健康状况
- 02寻找竞争对手的链接建设机会
- 03检查可疑链接是否仍然存在
- 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
详细介绍
反向链接概况分析
来源检测
分析前,检测可用的数据源:
- DataForSEO MCP(付费):检查是否有
backlinks_summary工具 - Moz API(免费注册):"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check moz --json
- Bing Webmaster(免费注册):"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check bing --json
- Keywords Everywhere(免费注册;提供域名排名和引荐域名数量):"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check keywordseverywhere --json
- Common Crawl(始终可用):提供域名级图谱及 PageRank
- 验证爬虫(始终可用):检查已知反向链接是否仍然存在
运行 "${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、调和中心性,以及低置信度的排名/存在情况数据。
评分:
| 指标 | 良好 | 警告 | 严重 |
|---|---|---|---|
| 引荐域名 | >100 | 20-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 > Moz | 1.0 / 0.85 |
| 域名质量分布 | 20% | DataForSEO > Moz DA 分布 | 1.0 / 0.85 |
| 锚文本自然度 | 15% | DataForSEO > Moz > Bing anchors | 1.0 / 0.85 / 0.70 |
| 有害链接比例 | 20% | DataForSEO > Moz spam score | 1.0 / 0.85 |
| 链接增长趋势 | 10% | 仅 DataForSEO | 1.0 |
| Follow/nofollow 比例 | 5% | DataForSEO > Bing details | 1.0 / 0.70 |
| 地理相关性 | 10% | DataForSEO > Bing country | 1.0 / 0.70 |
**数据充分性门槛:**统计 7 个因素中至少有一个可用数据源的因素数量。
- **4 个或更多因素有数据:**生成 0-100 的数值评分(按比例重新分配缺失因素的权重)
- **少于 4 个因素:**不要生成数值评分。改为显示:
显示可用的各项因素评分及其来源和置信度。 建议:"配置 Moz API(免费)以获得可评分的概况。运行Backlink Health Score: INSUFFICIENT DATA (X/7 factors scored)/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/fail | XX/100 | Moz (0.85) |
| 锚文本分布 | pass/warn/fail | XX/100 | Moz (0.85) |
| 引荐域名质量 | pass/warn/fail | XX/100 | CC (0.50) |
| 有害链接 | pass/warn/fail | XX/100 | Moz Spam (0.85) |
| 热门页面 | info | N/A | Moz (0.85) |
| 链接增长趋势 | pass/warn/fail | XX/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 个 |
回退顺序:
- DataForSEO 是否可用?→ 将其用作主要数据源(置信度:1.0)
- 是否配置了 Moz?→ 用于 DA/PA/垃圾评分/锚文本(置信度:0.85)
- 是否配置了 Bing?→ 仅用于已注册资源的链接和对比, 且仅当两个资源都可访问时(置信度:0.70)
- 未配置 Moz,但配置了 Keywords Everywhere?→ 用于仅包含排名的 Profile Overview 回退方案(置信度:0.60;单一指标,不含链接数量/锚文本)
- 始终:使用 Common Crawl 获取域名级指标(置信度:0.50)
- 始终:使用验证爬虫检查已知链接(置信度:0.95)
- 全部不可用?→“运行
/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 时加载)