Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Complete Ahrefs API integration for SEO analysis. Covers Site Explorer (domains, backlinks, rankings), Keywords Explorer (search volume, difficulty, SERP ana...
Complete Ahrefs API integration for SEO analysis. Covers Site Explorer (domains, backlinks, rankings), Keywords Explorer (search volume, difficulty, SERP ana...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Query and analyze SEO data using the Ahrefs API for backlinks, keywords, rankings, and competitive intelligence.
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
Get your API token from Ahrefs Account Settings Configure in OpenClaw: Add to ~/.openclaw/workspace/.env: AHREFS_API_TOKEN=your_api_token_here AHREFS_API_PLAN=enterprise # Options: lite, standard, advanced, enterprise Verify setup: grep AHREFS ~/.openclaw/workspace/.env
Domain Rating & Ahrefs Rank Basic backlinks stats (total counts) Organic keywords count Organic traffic estimates Top pages by traffic
Organic keywords with positions (all positions) Keywords in positions 1-3 (via org_keywords_1_3 metric) Referring domains list (basic)
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)
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)
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
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
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
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
Process multiple targets efficiently: Analyze up to 100 domains/URLs per request Bulk keyword metrics Batch backlink data Cost-effective for large datasets
Track brand performance: Brand mention metrics Share of voice Competitor brand comparison Sentiment analysis preparation
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)
Ahrefs API base URL: https://api.ahrefs.com/v3/site-explorer/
All requests require the API token in the header: Authorization: Bearer {AHREFS_API_TOKEN} Important: Use AHREFS_API_TOKEN, NOT AHREFS_MCP_TOKEN.
All API calls require: date: Current date in format YYYY-MM-DD target: Domain (e.g., example.com)
For detailed endpoint documentation and parameters, see references/api-endpoints.md.
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
Limit rows returned: Use limit parameter to reduce cost Select specific columns: Use select parameter for only needed fields Batch requests: Process multiple targets in one call (up to 100) Cache results: Store frequently accessed data locally Use date ranges: Limit historical data when not needed
60 requests per minute (default) HTTP 429 returned if limit exceeded Implement exponential backoff for retries
DATE=$(date +%Y-%m-%d) curl -X GET "https://api.ahrefs.com/v3/site-explorer/backlinks-stats?date=$DATE&target=example.com" \ -H "Authorization: Bearer $AHREFS_API_TOKEN" Returns: { "metrics": { "live": 4545, "all_time": 25318, "live_refdomains": 718, "all_time_refdomains": 3272 } }
DATE=$(date +%Y-%m-%d) curl -X GET "https://api.ahrefs.com/v3/site-explorer/metrics?date=$DATE&target=example.com" \ -H "Authorization: Bearer $AHREFS_API_TOKEN" Returns: { "metrics": { "org_keywords": 6925, "org_traffic": 38702, "org_keywords_1_3": 1560, "org_cost": 2372016 } }
DATE=$(date +%Y-%m-%d) curl -X GET "https://api.ahrefs.com/v3/site-explorer/domain-rating?date=$DATE&target=example.com" \ -H "Authorization: Bearer $AHREFS_API_TOKEN" Returns: { "domain_rating": { "domain_rating": 43.0, "ahrefs_rank": 1189155 } }
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" \ -H "Authorization: Bearer $AHREFS_API_TOKEN"
curl -X GET "https://api.ahrefs.com/v3/keywords-explorer/overview?keyword=seo+tools&country=us" \ -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 }
curl -X GET "https://api.ahrefs.com/v3/keywords-explorer/related-keywords?keyword=seo+tools&country=us&limit=50" \ -H "Authorization: Bearer $AHREFS_API_TOKEN"
curl -X GET "https://api.ahrefs.com/v3/serp-overview?keyword=seo+tools&country=us" \ -H "Authorization: Bearer $AHREFS_API_TOKEN" Returns top 100 organic results with domain metrics.
Note: Requires pre-configured project in Ahrefs web interface. curl -X GET "https://api.ahrefs.com/v3/rank-tracker/project?project_id=12345" \ -H "Authorization: Bearer $AHREFS_API_TOKEN"
Note: Requires pre-configured project in Ahrefs web interface. curl -X GET "https://api.ahrefs.com/v3/site-audit/project?project_id=12345" \ -H "Authorization: Bearer $AHREFS_API_TOKEN"
curl -X POST "https://api.ahrefs.com/v3/site-explorer/batch/metrics" \ -H "Authorization: Bearer $AHREFS_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "targets": ["example.com", "competitor1.com", "competitor2.com"], "date": "2026-02-18" }' Returns metrics for all domains in one request.
Get keyword overview (volume, difficulty, CPC) Fetch related keywords and questions Analyze SERP for top-ranking content Identify keyword difficulty and traffic potential Export prioritized keyword list
Compare domain metrics (DR, traffic, keywords) Analyze competitor backlink profiles Identify content gaps Find keywords competitors rank for but you don't Discover backlink opportunities
Requires Site Audit project Fetch site health overview Identify critical issues by severity Analyze internal linking structure Review page performance metrics Generate prioritized fix list
Research target keywords (Keywords Explorer) Analyze top-ranking content (SERP Overview) Identify content gaps vs competitors Plan content based on traffic potential Track rankings over time (Rank Tracker)
Compile list of target domains Make batch API request (up to 100 domains) Compare metrics across all domains Identify patterns and opportunities Export comparative analysis
Rate Limits: Respect API rate limits (60 req/min default) API Units: Monitor usage and optimize queries (limit rows, select columns) Caching: Cache responses for frequently accessed data Pagination: Use limit and offset parameters for large datasets Batch Requests: Use batch endpoints when analyzing multiple targets Error Handling: Check for 401 (auth), 429 (rate limit), 404 (not found) Project Requirements: Rank Tracker and Site Audit require pre-configured projects
Load the token from the workspace .env file: # PowerShell $env:AHREFS_API_TOKEN = (Get-Content ~/.openclaw/workspace/.env -Raw | Select-String "AHREFS_API_TOKEN=([^\r\n]+)" | ForEach-Object { $_.Matches.Groups[1].Value }) # Bash export AHREFS_API_TOKEN=$(grep AHREFS_API_TOKEN ~/.openclaw/workspace/.env | cut -d'=' -f2)
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 */ ] }
Verify token is correctly set in .env Check token hasn't expired Ensure Bearer token format in header
Implement exponential backoff Cache responses where appropriate Use batch endpoints when available
Verify domain/URL format Check if domain exists in Ahrefs index Try alternative target formats (with/without www)
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.