什么是 Ahrefs SEO 分析？

Openclaw Skills 的 Ahrefs 技能为全球最强大的 SEO 数据集之一提供了全面接口。它使 AI 代理能够以编程方式访问 Site Explorer 获取域名指标，访问 Keywords Explorer 获取搜索量和难度，以及访问 Site Audit 获取技术健康分数。此集成专为需要自动化竞争对手情报、监控排名并识别增长机会而无需手动导出仪表板的开发人员和营销人员设计。

通过将您的 Ahrefs 账户连接到 AI 工作区，您可以执行复杂任务，如内容差距分析或批量域名处理。该技能支持从入门版到企业版的不同订阅层级，根据您的特定 API 方案调整其功能和过滤选项，确保您从 API 单元中获得最大价值。

下载入口:https://github.com/openclaw/skills/tree/main/skills/geozhu/ahrefs

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Ahrefs SEO 分析 应用场景

• 审计竞争对手的反向链接概况，以识别高权威的外链建设机会。
• 生成包含搜索量、难度和流量潜力的自动化关键词研究报告。
• 监控一系列网站的域名评分 (DR) 和自然流量趋势。
• 通过自动化审计识别技术性 SEO 问题和网站健康分数。
• 对多个域名进行批量分析，以比较市场份额和可见性。

1. 该技能使用存储在环境配置中的安全 Bearer 令牌与 Ahrefs v3 API 进行身份验证。
2. 发起查询时，代理会指定目标（域名、URL 或关键词）和所需的日期参数。
3. 该技能调用相关的 Ahrefs 端点，例如用于域名统计的 Site Explorer 或用于搜索数据的 Keywords Explorer。
4. 它通过应用过滤器和选择特定数据列来优化成本，管理 API 单元消耗。
5. 结构化的 JSON 响应将返回给代理，提供 DR、UR、自然流量和关键词排名等具有操作价值的指标。

Ahrefs SEO 分析 配置指南

要在 Openclaw Skills 中开始使用此技能，请执行以下步骤：

1. 从 Ahrefs 账户设置 获取您的 API 令牌。
2. 将您的凭据添加到 ~/.openclaw/workspace/.env 文件中：

AHREFS_API_TOKEN=your_api_token_here
AHREFS_API_PLAN=enterprise # 选项：lite, standard, advanced, enterprise

3. 验证环境变量是否已正确加载：

grep AHREFS ~/.openclaw/workspace/.env

Ahrefs SEO 分析 数据架构与分类体系

该技能将从 Ahrefs API 检索的数据组织成结构化格式。大多数响应分为两类：统计数据（指标）和列表（数据数组）。

所有请求均使用 target 参数和 YYYY-MM-DD 格式的 date，以确保数据准确性和历史相关性。

name: ahrefs
description: Complete Ahrefs API integration for SEO analysis. Covers Site Explorer (domains, backlinks, rankings), Keywords Explorer (search volume, difficulty, SERP analysis), Rank Tracker (position monitoring), Site Audit (technical SEO), SERP Overview, Batch Analysis, and Brand Radar. Use for any SEO-related queries including keyword research, backlink analysis, competitor intelligence, technical audits, and rank tracking.
version: 1.2.0

Ahrefs SEO Analysis

Query and analyze SEO data using the Ahrefs API for backlinks, keywords, rankings, and competitive intelligence.

Prerequisites

API Access

You need an Ahrefs subscription with API access:

• Lite: Basic metrics, limited filtering
• Standard: More endpoints, some filtering
• Advanced: Advanced filtering, more data
• Enterprise: Full API access, advanced filtering, high rate limits

Setup

1. Get your API token from Ahrefs Account Settings

2. Configure in OpenClaw: Add to ~/.openclaw/workspace/.env:

   AHREFS_API_TOKEN=your_api_token_here
   AHREFS_API_PLAN=enterprise  # Options: lite, standard, advanced, enterprise
   

3. Verify setup:

   grep AHREFS ~/.openclaw/workspace/.env
   

Plan-Specific Features

All Plans

• Domain Rating & Ahrefs Rank
• Basic backlinks stats (total counts)
• Organic keywords count
• Organic traffic estimates
• Top pages by traffic

Standard & Above

• Organic keywords with positions (all positions)
• Keywords in positions 1-3 (via org_keywords_1_3 metric)
• Referring domains list (basic)

Advanced & Enterprise

• Advanced filtering: Filter keywords by position (1-10 for first page)
• Geographic filtering: Filter backlinks by country/TLD (e.g., .au domains)
• Detailed keyword data: Access to best_position, sum_traffic, volume
• Detailed backlink data: Full backlinks list with filtering
• Higher rate limits: Fetch larger datasets (5000+ records)

Core Capabilities

Site Explorer (Domain Analysis)

Get comprehensive SEO metrics for any domain:

• Domain Rating (DR) & URL Rating (UR)
• Organic traffic estimates
• Referring domains & backlinks
• Organic keywords & rankings
• Top pages by traffic
• Historical data & trends
• [Advanced/Enterprise] Filter by country/TLD
• [Advanced/Enterprise] Position-based filtering (first page only)

Keywords Explorer (Keyword Research)

Discover and analyze keywords:

• Search volume (global & country-specific)
• Keyword difficulty (KD) score
• Cost per click (CPC) estimates
• SERP analysis & features
• Related keywords & questions
• Keyword ideas & suggestions
• Parent topic analysis
• Traffic potential estimates

Rank Tracker (Position Monitoring)

Track keyword rankings over time:

• Position tracking & visibility
• Competitor rankings comparison
• SERP feature tracking
• Historical position data
• Share of voice metrics
• Note: Requires pre-configured projects in Ahrefs

Site Audit (Technical SEO)

Identify technical SEO issues:

• Crawl data & site health scores
• On-page issues by severity
• Internal link analysis
• Page performance metrics
• Mobile usability issues
• Note: Requires pre-configured projects in Ahrefs

SERP Overview (Search Results)

Analyze search engine results:

• Top 100 organic results for any keyword
• SERP features present
• Domain metrics for ranking pages
• Keyword difficulty breakdown
• Click-through rate estimates

Batch Analysis (Bulk Processing)

Process multiple targets efficiently:

• Analyze up to 100 domains/URLs per request
• Bulk keyword metrics
• Batch backlink data
• Cost-effective for large datasets

Brand Radar (Brand Monitoring)

Track brand performance:

• Brand mention metrics
• Share of voice
• Competitor brand comparison
• Sentiment analysis preparation

Competitor Analysis

Compare domains and identify opportunities:

• Side-by-side domain comparison
• Content gap analysis
• Keyword overlaps & differences
• Backlink gap analysis
• Traffic comparison
• [Advanced/Enterprise] Filtered comparisons (first page keywords, local backlinks)

API Structure

Ahrefs API base URL: https://api.ahrefs.com/v3/site-explorer/

Authentication

All requests require the API token in the header:

Authorization: Bearer {AHREFS_API_TOKEN}

Important: Use AHREFS_API_TOKEN, NOT AHREFS_MCP_TOKEN.

Required Parameters

All API calls require:

• date: Current date in format YYYY-MM-DD
• target: Domain (e.g., example.com)

Common Endpoints

For detailed endpoint documentation and parameters, see references/api-endpoints.md.

API Unit Management

Understanding API Units

• Each API request consumes units from your monthly allowance
• Cost depends on rows returned (minimum 50 units per request)
• Enterprise plans include units; additional units can be purchased
• Track usage at: https://app.ahrefs.com/account/limits-and-usage/web

Cost Optimization Tips

1. Limit rows returned: Use limit parameter to reduce cost
2. Select specific columns: Use select parameter for only needed fields
3. Batch requests: Process multiple targets in one call (up to 100)
4. Cache results: Store frequently accessed data locally
5. Use date ranges: Limit historical data when not needed

Rate Limits

• 60 requests per minute (default)
• HTTP 429 returned if limit exceeded
• Implement exponential backoff for retries

Usage Examples

Site Explorer - Get Backlinks & Referring Domains

DATE=$(date +%Y-%m-%d)
curl -X GET "https://api.ahrefs.com/v3/site-explorer/backlinks-stats?date=$DATE&target=example.com" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

Returns:

{
  "metrics": {
    "live": 4545,
    "all_time": 25318,
    "live_refdomains": 718,
    "all_time_refdomains": 3272
  }
}

Get Organic Keywords & Traffic

DATE=$(date +%Y-%m-%d)
curl -X GET "https://api.ahrefs.com/v3/site-explorer/metrics?date=$DATE&target=example.com" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

Returns:

{
  "metrics": {
    "org_keywords": 6925,
    "org_traffic": 38702,
    "org_keywords_1_3": 1560,
    "org_cost": 2372016
  }
}

Get Domain Rating

DATE=$(date +%Y-%m-%d)
curl -X GET "https://api.ahrefs.com/v3/site-explorer/domain-rating?date=$DATE&target=example.com" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

Returns:

{
  "domain_rating": {
    "domain_rating": 43.0,
    "ahrefs_rank": 1189155
  }
}

Get Top Pages

DATE=$(date +%Y-%m-%d)
curl -X GET "https://api.ahrefs.com/v3/site-explorer/top-pages?date=$DATE&target=example.com&limit=10&select=url,sum_traffic" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

Keywords Explorer - Keyword Research

curl -X GET "https://api.ahrefs.com/v3/keywords-explorer/overview?keyword=seo+tools&country=us" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

Returns:

{
  "keyword": "seo tools",
  "volume": 14000,
  "keyword_difficulty": 75,
  "cpc": 25.50,
  "serp_features": ["featured_snippet", "people_also_ask"],
  "traffic_potential": 18500
}

Keywords Explorer - Related Keywords

curl -X GET "https://api.ahrefs.com/v3/keywords-explorer/related-keywords?keyword=seo+tools&country=us&limit=50" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

SERP Overview - Analyze Search Results

curl -X GET "https://api.ahrefs.com/v3/serp-overview?keyword=seo+tools&country=us" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

Returns top 100 organic results with domain metrics.

Rank Tracker - Get Project Rankings

Note: Requires pre-configured project in Ahrefs web interface.

curl -X GET "https://api.ahrefs.com/v3/rank-tracker/project?project_id=12345" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

Site Audit - Get Project Issues

Note: Requires pre-configured project in Ahrefs web interface.

curl -X GET "https://api.ahrefs.com/v3/site-audit/project?project_id=12345" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN"

Batch Analysis - Multiple Domains

curl -X POST "https://api.ahrefs.com/v3/site-explorer/batch/metrics" r
  -H "Authorization: Bearer $AHREFS_API_TOKEN" r
  -H "Content-Type: application/json" r
  -d '{
    "targets": ["example.com", "competitor1.com", "competitor2.com"],
    "date": "2026-02-18"
  }'

Returns metrics for all domains in one request.

Common Workflows

Keyword Research Workflow

1. Get keyword overview (volume, difficulty, CPC)
2. Fetch related keywords and questions
3. Analyze SERP for top-ranking content
4. Identify keyword difficulty and traffic potential
5. Export prioritized keyword list

Competitive Analysis Workflow

1. Compare domain metrics (DR, traffic, keywords)
2. Analyze competitor backlink profiles
3. Identify content gaps
4. Find keywords competitors rank for but you don't
5. Discover backlink opportunities

Technical SEO Audit Workflow

Requires Site Audit project

1. Fetch site health overview
2. Identify critical issues by severity
3. Analyze internal linking structure
4. Review page performance metrics
5. Generate prioritized fix list

Content Strategy Workflow

1. Research target keywords (Keywords Explorer)
2. Analyze top-ranking content (SERP Overview)
3. Identify content gaps vs competitors
4. Plan content based on traffic potential
5. Track rankings over time (Rank Tracker)

Batch Domain Analysis Workflow

1. Compile list of target domains
2. Make batch API request (up to 100 domains)
3. Compare metrics across all domains
4. Identify patterns and opportunities
5. Export comparative analysis

Best Practices

1. Rate Limits: Respect API rate limits (60 req/min default)
2. API Units: Monitor usage and optimize queries (limit rows, select columns)
3. Caching: Cache responses for frequently accessed data
4. Pagination: Use limit and offset parameters for large datasets
5. Batch Requests: Use batch endpoints when analyzing multiple targets
6. Error Handling: Check for 401 (auth), 429 (rate limit), 404 (not found)
7. Project Requirements: Rank Tracker and Site Audit require pre-configured projects

Environment Variables

Load the token from the workspace .env file:

# PowerShell
$env:AHREFS_API_TOKEN = (Get-Content ~/.openclaw/workspace/.env -Raw | Select-String "AHREFS_API_TOKEN=([^
]+)" | ForEach-Object { $_.Matches.Groups[1].Value })

# Bash
export AHREFS_API_TOKEN=$(grep AHREFS_API_TOKEN ~/.openclaw/workspace/.env | cut -d'=' -f2)

Response Format

API responses vary by endpoint but typically return JSON:

Stats endpoints (backlinks-stats, metrics, domain-rating):

{
  "metrics": { /* metric fields */ },
  "domain_rating": { /* rating fields */ }
}

List endpoints (top-pages, backlinks, etc.):

{
  "pages": [ /* array of results */ ],
  "backlinks": [ /* array of results */ ]
}

Troubleshooting

Authentication Errors

• Verify token is correctly set in .env
• Check token hasn't expired
• Ensure Bearer token format in header

Rate Limiting

• Implement exponential backoff
• Cache responses where appropriate
• Use batch endpoints when available

Data Not Found

• Verify domain/URL format
• Check if domain exists in Ahrefs index
• Try alternative target formats (with/without www)