sales-ahrefs

用途

本技能为 Ahrefs（ahrefs.com）平台提供使用帮助。Ahrefs 是业界领先的 SEO 工具套件，包含 Site Explorer（外链、自然关键词、Domain Rating）、Keywords Explorer、Rank Tracker 等工具。该技能用于解答与操作以下任务类型：

A) 构建 API 集成——拉取外链、自然关键词、Domain Rating、排名数据
B) 设置 MCP 服务器，使 Claude/ChatGPT 可通过提示词查询你的 Ahrefs 账户
C) 修复 API 单元／月度额度耗尽、超额费用，或「可疑活动」限流
D) 将已失效的 v2 集成迁移到 v3
E) 选择／理解方案——Starter、Lite、Standard、Advanced、Enterprise；额度与 API 单元模型
F) 使用具体工具——Site Explorer、Keywords Explorer、Rank Tracker、Site Audit、Content Explorer、Brand Radar

主要能力与关键规则

REST 还是 MCP？定时管道／导出使用 REST API（配合严格的 select）；临时性智能体提问使用 MCP 服务器。两者消耗相同的 API 单元。

使用建议围绕以下几点展开：

像花钱一样预算 API 单元。每次数据调用至少花费 50 单元，并随行数 × 字段数增加。始终传递 select（只取需要的字段）、限制 limit、对多目标优先使用 batch-analysis、缓存结果，并轮询 /subscription-info/limits-and-usage。这一纪律可避免大多数「额度耗尽」的痛苦。
仅使用 v3。v2 已于 2025-11-01 完全停用，任何 v2 教程／端点都已失效。需使用新密钥与 v3 路径。
智能体用 MCP，管道用 REST。官方 MCP（Lite 及以上）允许 Claude/ChatGPT 通过提示词拉取数据；它占用相同的单元预算，因此智能体查询应保持具体。
为自动化调用限速。Ahrefs 的反滥用「可疑活动」系统会对突发性访问限流，即使仍在方案限额内——需添加抖动／退避，不要并行猛打。
了解真实成本。较低档位按额度计量（每份报告 1 个额度）；重度 API 使用需要付费 API 订阅（约 $500–$10k/月）或 Enterprise；Brand Radar、AI Content Helper、Report Builder 均为付费附加项。
它是只读的。没有写入 API，也没有事件 webhook——只能把数据拉出，推入你自己的系统。

使用方式

技能按步骤引导：

收集上下文。若存在 references/learnings.md，先阅读其中的平台知识积累。确认用户目标属于上述 A–F 哪一类。若提示词已提供足够上下文，可跳过此步直接进入下一步。
路由或直接回答。若问题涉及跨厂商的 SEO 策略、工具选择或内容优化，路由到 /sales-seo {question}；若涉及跨工具的 AI 搜索可见性（Brand Radar 类）追踪策略，路由到 /sales-ai-visibility {question}；若涉及将 Ahrefs 数据通用地连接到其他工具（iPaaS／数仓），路由到 /sales-integration {question}。路由时给出确切命令，例如：「这是 SEO 工具选择问题——运行：/sales-seo Ahrefs vs Semrush for a small content team on a budget」。
查阅平台参考。阅读 references/platform-guide.md 获取完整参考——模块地图（哪些是 API／MCP／仅 UI）、定价模型（较低档的额度系统、API 单元分配与重度使用时付费 API 订阅／Enterprise、$199／$99 附加项、无免费试用）、含 JSON 结构的数据模型，以及快速上手配方（按单元意识拉取竞品关键词、将 MCP 接入 Claude、用 batch-analysis 批量评分域名）。阅读 references/ahrefs-api-reference.md 获取集成面——基础地址 https://api.ahrefs.com/v3、Bearer 认证（密钥来自 Account → API keys，仅所有者／管理员，1 年有效期）、API 单元成本模型（最低 50 单元，随行数 × 字段数增加，部分端点免费）、端点分组（Site Explorer、Keywords Explorer、Rank Tracker、Site Audit、Batch Analysis、limits-and-usage），以及官方 MCP 服务器的设置。只使用相关章节作答，不要倾倒整份参考。
给出可执行指导。聚焦用户的具体情况，并将可复用的小技巧补充到 references/learnings.md。

示例命令：claude mcp add --transport http ahrefs "https://mcp.ahrefs.com" --header "Authorization: Bearer $KEY"（需在 MCP 文档中核实托管 URL）。

适用场景

适用于开发者与自动化场景（通过 API 按单元高效导出竞品关键词）、希望用提示词让 Claude 直接查询 Ahrefs 数据的场景、排查额度与账单膨胀、迁移旧版 v2 集成、选择方案，以及使用具体 Ahrefs 工具。

限制与注意事项

以下内容基于研究整理（2026-06），属尽力而为，尤其是定价／额度和单元模型经常变化，请自行复核：

若不使用 select，API 单元会很快耗尽。每请求最低 50 单元，随行数 × 字段数增加。只请求需要的字段和行，使用 batch-analysis 并缓存。
API v2 已失效（自 2025-11-01 起）。只能用新密钥构建 v3；旧 v2 集成已无数据访问。
「可疑活动」锁定会波及合法用户。激进的防滥用限流可能在方案限额内也限制你——需限速并对自动化调用退避。
额度 ≠ API 单元。应用内额度系统（每份报告 1 个，例如 Lite 每月 500）与 API 单元分配是分开的。两者都可能耗尽，都会导致超额／受限。
重度 API 使用昂贵。包含的单元分配适合轻度使用；生产量级需要付费 API 订阅（$500–$10k/月）或 Enterprise。
无免费试用；Starter 是低成本的评估路径。不要期待试用——Starter（$29）是成本最低的评估方式。
附加项会叠加计费。Brand Radar（$199）、AI Content Helper（$99）、Report Builder（$99）在基础方案之上另行计费。
无联盟计划，也无 webhook。不要寻找这两者——Ahrefs 是只读研究工具，刻意不设联盟计划。

故障排查要点

API 调用失败或返回「out of units」：症状为请求报错或月中停止返回数据；原因是月度 API 单元分配耗尽（最低 50 单元／请求，随行数 × 字段数增加），或方案分配仅适合轻度使用。解决：添加 select 仅取所需字段、降低 limit、将多次单独调用改为 batch-analysis、缓存结果、监控 /subscription-info/limits-and-usage；持续量级需转向付费 API 订阅或 Enterprise；确认使用 v3（v2 已于 2025-11-01 停用）。
仍在方案内却被限流／锁定：症状为限额内仍被限制或「可疑活动」阻断；原因是反滥用系统标记突发性／自动化访问模式；解决：对请求限速（加延迟与抖动）、避免高度并行、遇 429 退避、将大任务分散到更长时间；若合法工作流被阻断，携带用例联系 Ahrefs 支持。
旧版 API 集成停止返回数据：症状为原本可用的集成现在无数据或报错；原因是基于 API v2，已于 2025-11-01 完全停用；解决：在 API v3 上重建（基础地址 https://api.ahrefs.com/v3，Bearer 密钥来自 Account → API keys），更新端点路径至 v3 分组，并采用单元纪律（select、limit、batch）；对 AI 智能体可考虑改用 MCP 服务器。

技能介绍

用途