ahrefs
Query Ahrefs SEO data — backlinks, domain rating, organic keywords, competitors, and SERP analysis. Use for competitive analysis, link building, and keyword research.
SKILL.mdskills/teamday/ahrefs/SKILL.md
GitHubAhrefs SEO Analysis Skill
Query Ahrefs API for backlink data, domain metrics, keyword research, and competitive analysis.
Quick Start (After OAuth)
First authenticate: Run /mcp in Claude Code and authorize with Ahrefs.
Then use MCP tools:
# Domain Rating & Overview
mcp__ahrefs__site-explorer-domain-rating(target="your-domain.com", date="2026-01-26")
mcp__ahrefs__site-explorer-metrics(target="your-domain.com", date="2026-01-26")
mcp__ahrefs__site-explorer-backlinks-stats(target="your-domain.com", date="2026-01-26")
# Top Organic Keywords
mcp__ahrefs__site-explorer-organic-keywords(
target="your-domain.com",
date="2026-01-26",
country="us",
select="keyword,position,volume,traffic,keyword_difficulty"
)
# Organic Competitors
mcp__ahrefs__site-explorer-organic-competitors(
target="your-domain.com",
date="2026-01-26",
country="us",
select="domain,common_keywords,org_traffic,domain_rating"
)
# Top Pages by Traffic
mcp__ahrefs__site-explorer-top-pages(
target="your-domain.com",
date="2026-01-26",
select="url,traffic,keywords,top_keyword"
)
# Referring Domains (Backlinks)
mcp__ahrefs__site-explorer-refdomains(
target="your-domain.com",
select="domain,domain_rating,backlinks,first_seen"
)
# Keyword Research
mcp__ahrefs__keywords-explorer-overview(
keywords="your target keyword",
country="us",
select="keyword,volume,keyword_difficulty,cpc,traffic_potential"
)
# SERP Analysis
mcp__ahrefs__serp-overview-serp-overview(
keyword="your target keyword",
country="us",
select="position,url,domain_rating,traffic,backlinks"
)
Available MCP Tools
| Tool | Purpose | Key Params |
|---|---|---|
site-explorer-domain-rating |
DR score | target, date |
site-explorer-metrics |
Traffic, keywords count | target, date, country |
site-explorer-backlinks-stats |
Backlink counts | target, date |
site-explorer-organic-keywords |
What you rank for | target, date, country, select |
site-explorer-organic-competitors |
Who you compete with | target, date, country, select |
site-explorer-top-pages |
Best performing pages | target, date, select |
site-explorer-refdomains |
Who links to you | target, select |
site-explorer-all-backlinks |
Individual backlinks | target, select |
site-explorer-broken-backlinks |
Broken links to fix | target, select |
keywords-explorer-overview |
Keyword research | keywords, country, select |
keywords-explorer-matching-terms |
Keyword ideas | keywords, country, select |
serp-overview-serp-overview |
SERP analysis | keyword, country, select |
When to Use
- Competitive Analysis: Compare your domain to competitors
- Link Building: Find backlink opportunities, broken links to reclaim
- Keyword Research: Discover keywords and their difficulty
- Content Strategy: See what pages drive organic traffic
- SERP Analysis: Understand ranking difficulty for target keywords
Configuration
Two authentication methods available:
Method 1: Remote MCP with OAuth (Recommended)
Uses your Ahrefs subscription with full access to all endpoints.
# Authenticate via MCP:
/mcp
# Browser opens -> Login to Ahrefs -> Authorize
Method 2: Direct Scripts (Using OAuth Token)
Claude Code stores OAuth tokens in macOS Keychain. After /mcp auth, you can extract the token:
bun .claude/skills/ahrefs/scripts/get-ahrefs-token.ts
bun .claude/skills/ahrefs/scripts/get-ahrefs-token.ts --json
Common Use Cases
1. Competitor Analysis
bun .claude/skills/ahrefs/scripts/ahrefs-api.ts overview competitor.com
bun .claude/skills/ahrefs/scripts/ahrefs-api.ts keywords competitor.com 50
bun .claude/skills/ahrefs/scripts/ahrefs-api.ts competitors your-domain.com
2. Link Building
bun .claude/skills/ahrefs/scripts/ahrefs-api.ts refdomains your-domain.com 50
bun .claude/skills/ahrefs/scripts/ahrefs-api.ts broken-backlinks your-domain.com
3. Keyword Research
bun .claude/skills/ahrefs/scripts/ahrefs-api.ts keyword-overview "your keyword"
bun .claude/skills/ahrefs/scripts/ahrefs-api.ts serp "your keyword"
API Limits
Ahrefs API uses units. Each call consumes units based on complexity:
- Simple metrics (DR): ~1 unit
- Backlinks list: ~5-10 units
- Keyword research: ~10 units
Monitor your usage at: https://app.ahrefs.com/api-profile