用途：在 Python 项目中程序化访问 Ahrefs SEO 数据，适用于 SEO 与营销相关任务。主要能力：Site Explorer（外链、自然关键词、域名评分、流量、引用域）、Keywords Explorer（关键词量、难度、相关词）、Rank Tracker（SERP 监控与竞品跟踪）、Site Audit（技术 SEO 问题、页面内容）、Brand Radar（AI 品牌提及、声量份额、曝光）、SERP Overview、Batch Analysis（批量域名/URL 指标 POST）。共 52 个方法、7 个 API 分区。
安装：pip3 install git+https://github.com/ahrefs/ahrefs-python.git，需 Python 3.11+，依赖 httpx、pydantic。
方法发现：Python 内 from ahrefs.search import search_api_methods，调用 search_api_methods("domain rating")；终端用 python3 -m ahrefs.api_search "domain rating"，可加 --section、--limit、--json、--sections。
使用方式：始终使用该 SDK，不要用 httpx/requests 直接请求 API；密钥从 AHREFS_API_KEY 读取，禁止硬编码；日期用 YYYY-MM-DD 字符串；列表端点务必用 select 指定所需列；用 with / async with 管理客户端生命周期；客户端已自动处理 429、5xx 与连接错误重试。支持同步 AhrefsClient 与异步 AsyncAhrefsClient，可用 asyncio.gather 并发。方法命名形如 site_explorer_domain_rating，可传关键字参数或请求对象。列表端点无分页，用 limit 控制条数；where 参数为 JSON 字符串。异常均继承自 ahrefs.AhrefsError，包括 AuthenticationError、RateLimitError、NotFoundError、APIError、APIConnectionError。枚举参数可传普通字符串。
限制：具体收费、配额与官方未提供的信息暂未提供。