用途:该技能用于获取网站的 Domain Rating(域名评级,DR),通过 Ahrefs 免费公共 APIv3 端点实现。当用户询问 DR、domain rating、Ahrefs 评级或站点权威度时使用。
主要能力:调用免费公共端点获得目标的 DR 数值。免费表示 Ahrefs 不扣 API 单位,但并不代表无需鉴权:缺少 Bearer token 会返回 403 Forbidden,必须始终携带免费的 APIv3 密钥。
使用方式:API 密钥保存在 ~/.config/opencode/skills/ahrefs-dr/.env,变量名为 AHREFS_API_KEY,需加载但不得打印密钥,也不得提交 .env。若值为空,应停止并请用户从 https://app.ahrefs.com/account/api-keys 粘贴密钥。免费账户即可,密钥在 Account settings → API keys 生成,以 Authorization: Bearer <token> 发送。target 为必填,可传域名或 URL,使用 --data-urlencode 保证查询字符合法。请求示例:curl -sS --fail-with-body -G 'https://api.ahrefs.com/v3/public/domain-rating-free' --data-urlencode 'target=playwriter.dev' -H 'Accept: application/json' -H "Authorization: Bearer $AHREFS_API_KEY"。响应含 domain_rating.domain_rating 与 license 字段,输出数值时标注为 DR,并附署名:Domain Rating by Ahrefs (https://ahrefs.com/),License: http://ahrefs.com/legal/domain-rating-license。使用前应先获取最新文档:curl -sL https://docs.ahrefs.com/en/api/reference/public/get-domain-rating-free。
规则与限制:始终使用该免费公共端点,不要用付费 Site Explorer 端点查 DR。用户给完整 URL 时一般只传主机名,除非其要求以该 URL 为 target。遇到 401 表示密钥缺失或无效,应停止,不要用猜测密钥重试;遇到 429 应等待后重试一次,不要循环。文档不可截断处理,勿用 head、tail、sed -n、awk、less 等截断命令。其余限制资料未提供。