ahrefs

# 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](https://ahrefs.com/api)

2. **Configure in OpenClaw**:
   Add to `~/.openclaw/workspace/.env`:
   ```bash
   AHREFS_API_TOKEN=your_api_token_here
   AHREFS_API_PLAN=enterprise  # Options: lite, standard, advanced, enterprise
   ```

3. **Verify setup**:
   ```bash
   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 Resea...

# Ahrefs SEO Analysis Skill

> **Complete Ahrefs API integration for OpenClaw - The most comprehensive SEO analysis skill**

[![Version](https://img.shields.io/badge/version-1.2.0-blue.svg)](CHANGELOG.md)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

Full-featured Ahrefs API integration covering Site Explorer, Keywords Explorer, Rank Tracker, Site Audit, SERP Overview, Batch Analysis, and Brand Radar.

## Features

### Site Explorer
- 📊 Domain metrics (DR, UR, traffic, keywords)
- 🔗 Backlinks analysis with geographic filtering
- 📈 Organic keyword research with position filtering
- 🏆 Competitor analysis and comparisons
- 🌏 Country-specific filtering (Advanced/Enterprise)

### Keywords Explorer
- 🔍 Search volume & keyword difficulty
- 💰 CPC estimates & traffic potential
- 🎯 Related keywords & questions
- 📋 SERP analysis & features
- 🔄 Batch keyword processing (up to 100)

### Rank Tracker
- 📍 Position tracking & monitoring
- 📊 Historical ranking data
- 🥊 Competitor rankings comparison
- 📢 Share of voice metrics
- 🎯 SERP feature tracking

### Site Audit
- ✅ Site health scoring
- 🐛 Technical SEO issue detection
- 🔗 Internal link analysis
- ⚡ Page performance metrics
- 📋 Duplicate content detection

### Advanced Features
- 📦 Batch analysis (up to 100 targets)
- 📡 Brand mention monitoring
- 🎯 Unlinked mention discovery
- 💬 Share of voice comparison
- 💵 API unit cost optimization

## Prerequisites

### Ahrefs Subscription

You need an Ahrefs subscription with API access:

| Plan | Features | Best For |
|------|----------|----------|
| **Lite** | Basic metrics, limited filtering | Quick domain checks, basic stats |
| **Standard** | More endpoints, some filtering | Regular SEO audits, basic competitor analysis |
| **Advanced** | Advanced filtering, more data | Professional SEO work, detailed analysis |
| **Enterprise** | Full API access, advanced filtering, high limits | Agencies, large-scale SEO operations |

Get your AP...