技能介绍

问题：Ahrefs 数据散落在多个入口

手工导出反链、关键词、排名和技术问题，需要在页面之间反复切换；自己写脚本直接请求 API，又容易遇到签名不统一、日期格式混乱、重试缺失、返回字段过大等问题。这个技能把官方 Python SDK 封装成可检索、可调用的分析入口，让工程化取数不必从零拼装。

工作方式：以 SDK 为中心

统一能力入口：覆盖 Site Explorer、Keywords Explorer、Rank Tracker、Site Audit、Brand Radar、SERP Overview 与 Batch Analysis 等 7 个 API 分区，共 52 个方法。
方法发现：用 search_api_methods("query") 或 CLI 搜索关键词，返回签名、参数与返回字段，不必翻大段参考文档。
调用方式：方法名遵循 {api_section}_{endpoint}，如 site_explorer_organic_keywords；标量端点返回单个 data 对象，列表端点返回 data 列表。
参数控制：列表端点支持 target、date、date_from/date_to、country、select、where、order_by、limit。日期必须是 YYYY-MM-DD 字符串；select 只取所需列，避免浪费 API units。
筛选表达式：where 接收 JSON 字符串，可用 json.dumps() 构造；枚举参数直接传字符串，例如 country="us"。
错误处理：异常统一继承 ahrefs.AhrefsError，客户端自动处理 429、5xx 与连接错误，不需要自行实现重试。

适用边界

它适合结构化读取 Ahrefs 官方数据；凭据通过 AHREFS_API_KEY 或首选 secret 机制管理，不硬编码、不回显、不记录、不转发。涉及发送、发布、删除、付款、部署或其他外部写入时，需要先展示目标与影响并获得明确确认。命令和代码默认作为参考，仅在用户明确要求且目标范围清楚时执行。