Ahrefs 搜索优化助手

解决的痛点

在终端环境下进行 SEO 分析时，频繁切换浏览器、导出 CSV、手动清洗数据会打断开发与运维的工作流。这套技能将 Ahrefs 的搜索分析能力直接接入 Claude Code，让你无需离开终端即可获取外链画像、关键词指标和历史趋势数据，把数据拉取和初步分析的环节自动化。

核心能力与工作流

技能通过 Composio MCP 调用 Ahrefs 的底层 API，主要覆盖以下几类分析场景：

• 站点指标探索：调用 AHREFS_RETRIEVE_SITE_EXPLORER_METRICS 获取域名的反向链接数、引用域、自然关键词排名和流量估算。
• 历史趋势追踪：利用 AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY 和 AHREFS_DOMAIN_RATING_HISTORY 对比历史数据，分析 DR 值或流量的变化趋势。
• 外链与关键词分析：通过 AHREFS_FETCH_ALL_BACKLINKS 抓取包含锚文本和属性的外链列表；使用 AHREFS_EXPLORE_KEYWORDS_OVERVIEW 和 AHREFS_RETRIEVE_ORGANIC_KEYWORDS 进行关键词拓展与自然排名审计。
• 批量对比：使用 AHREFS_BATCH_URL_ANALYSIS 一次性对比最多 100 个竞品或子页面的 SEO 指标。

适用边界与避坑指南

在使用这些工具时，有几个工程上的细节需要注意：

• 必须指定返回列：大多数工具强制要求 select 参数，遗漏或使用无效的列名会直接报错。
• API 额度消耗：不同的列消耗的 API unit 不同，像 traffic、difficulty 等高消耗列需要控制调用频率。
• 过滤语法：where 参数使用的是 Ahrefs 专有的过滤表达式，而非标准 SQL，需要查阅 schema 确认支持的过滤类型。
• 分页与模式：offset 参数已于 2024 年废弃，请改用游标分页或调整 limit。此外，mode 默认为 subdomains，如果不加控制会显著增加结果集的大小。