用途：通过 Ahrefs 官方 Python SDK 以类型化方式访问 Ahrefs API，适合 SEO 与营销数据分析、外链与关键词研究、排名与流量监测等任务。
主要能力：SDK 由 OpenAPI 规范自动生成，含 11 个 API 分区、105 个方法。涵盖 Site Explorer（外链、自然关键词、域名评分、流量、引用域）、Keywords Explorer、Rank Tracker 与 Management（项目、关键词列表、竞品、Brand Radar 提示管理）、Site Audit、Brand Radar、SERP Overview、Batch Analysis、Web Analytics（34 个端点，需 project_id）以及订阅用量信息；公开端点（爬虫 IP/CIDR）无需 API 密钥。
使用方式：需 Python 3.11+，安装命令为 pip3 install git+https://github.com/ahrefs/ahrefs-python.git，依赖 httpx 与 pydantic。用 with（或 async with）管理客户端生命周期，密钥通过环境变量 AHREFS_API_KEY 提供，禁止硬编码。方法名形如 {api_section}_{endpoint}，支持关键字参数或请求对象两种调用风格。可用 from ahrefs.search import search_api_methods 或 python3 -m ahrefs.api_search "query" 检索方法签名。日期一律为 YYYY-MM-DD 字符串；列表端点建议用 select 只取所需列，并用 limit 控制条数（无分页）；多独立请求可用 AsyncAhrefsClient 配合 asyncio.gather。客户端自动处理 429、5xx 与连接错误重试，无需自行实现重试。管理端点可修改状态，删除操作不可逆，调用前须与用户确认。
限制：除 public_* 方法外均需鉴权；keyword_list_id 无法通过 API 发现，须由用户在 Ahrefs 网页端提供；Brand Radar 提示需 report_id；Query 参数为 JSON 字符串；部分端点字段过多，需用 select 精简。其余收费、价格与详情暂未提供。