用途：通过 Ahrefs 远程 MCP 服务器（Streamable HTTP 传输）查询 SEO 数据，覆盖关键词研究、站点分析、SERP 分析、竞品研究、反向链接分析和 Brand Radar AI 可见度监控。
连接方式：端点 https://api.ahrefs.com/mcp/mcp，使用 Bearer token 鉴权（经 agent-secrets 租约 ahrefs_api_key），配置在 ~/.pi/agent/mcp.json 的 ahrefs 键下，lifecycle 为 lazy。服务器不支持 SSE，仅支持基于 POST 的 Streamable HTTP。注意：npm 的 @ahrefs/mcp 包不适用于 Standard 套餐鉴权，应使用远程端点。
主要能力：Keywords Explorer 提供关键词概览、匹配词、相关词、搜索建议、历史搜索量与分国家搜索量；Site Explorer 提供域名指标、自然关键词、自然竞品、热门页面、全部外链、引用域、DR 评分及历史、锚文本、失效外链等；SERP 概览；批量分析多个 URL/域名；Rank Tracker、Site Audit、Brand Radar、Web Analytics 需先在 Ahrefs UI 中完成项目或监控设置；管理类工具可列出项目、关键词、竞品、位置 ID，并查询订阅用量。
使用方式：首次调用数据工具前先调用 doc 工具获取真实输入 schema，例如 {"name":"doc","arguments":{"tool":"keywords-explorer-overview"}}。每次会话需先完成 MCP initialize 握手。where 参数使用 JSON 过滤表达式，支持 eq、neq、gt、gte、lt、lte、substring、isubstring、prefix、suffix、regex 及 and、or、not 组合。
限制与注意：每次调用消耗 API 单元，响应含 apiUsageCosts；金额字段（CPC、traffic_value 等）以美分计，需除以 100；difficulty 每行额外消耗 10 单元；Standard 套餐有月度单元上限，可用 subscription-info-limits-and-usage 查询。keywords-explorer-overview 仅返回数据库中精确存在的关键词，宽泛词可能为空，发现新词应使用 matching-terms 或 search-suggestions。日期格式为 YYYY-MM-DD，国家使用 ISO 两字母代码。target 可为域名、URL 或路径，mode 支持 exact、domain、subdomains、prefix。Rank Tracker、Site Audit、Brand Radar、Web Analytics 均依赖 Ahrefs UI 中的项目设置，需 project_id。具体价格与套餐细节以官方为准，资料未提供更多信息。