Ahrefs Organic Competitors
Identifies the top organic search competitors for a domain based on keyword overlap, sorted by common keywords descending.
References
@skills/seo/references/mcp-degradation.md @skills/seo/references/ahrefs-api-reference.md
Inputs
domain: The bare domain to analyze (e.g.,example.com). Striphttps://,http://, and trailing slashes before passing to Ahrefs tools.
MCP Check
Before proceeding, verify Ahrefs MCP is available:
- Use ToolSearch with query
+ahrefs - If tools are returned → Ahrefs MCP is available, proceed to Execution
- If no tools returned → display the Ahrefs MCP error template from
references/mcp-degradation.mdand stop
Execution
Step 1 — Call Organic Competitors
Call mcp__claude_ai_ahrefs__site-explorer-organic-competitors with:
target: the bare domain (e.g.,example.com)
Returns per competitor: domain, keyword overlap count, shared keywords, unique keywords (keywords competitor ranks for that target doesn't)
Step 2 — Sort and Analyze
- Sort by common keywords descending (most overlap = closest competitor)
- Identify top 3 competitors
- For each top competitor, note the unique keywords they rank for that the target domain does not — these represent content gap opportunities
Output Format
## Ahrefs Organic Competitors: example.com
### Competitor Landscape
| Domain | Common Keywords | Domain's Keywords | Competitor's Keywords | Traffic |
|--------|----------------|-------------------|----------------------|---------|
| competitor1.com | 4,230 | 12,450 | 18,900 | 145,000 |
| competitor2.com | 3,810 | 12,450 | 22,100 | 210,000 |
| competitor3.com | 2,950 | 12,450 | 9,800 | 67,000 |
### Top 3 Competitor Insights
**1. competitor1.com** (4,230 shared keywords)
- Unique strengths: ranks for 14,670 keywords you don't
- Opportunity: "product comparison" queries, "pricing" pages, "vs" content
**2. competitor2.com** (3,810 shared keywords)
- Unique strengths: ranks for 18,290 keywords you don't
- Opportunity: tutorial content, how-to guides, beginner-focused articles
**3. competitor3.com** (2,950 shared keywords)
- Unique strengths: ranks for 6,850 keywords you don't
- Opportunity: local/regional queries, case studies, integration pages
Error — Ahrefs MCP Not Available
If MCP check fails, display the Ahrefs error template from
references/mcp-degradation.md:
## Ahrefs MCP Not Available
The `/seo ahrefs competitors` command requires the Ahrefs MCP, which is not
currently connected.
**What you can do:**
- Use `/seo audit <url>` for a full static SEO analysis without live Ahrefs data
- Use `/seo technical <url>` for technical SEO issues without backlink/keyword data
**To connect Ahrefs MCP:**
- Ensure the Ahrefs MCP is registered at user scope in ~/.claude/mcp.json
- Verify with: cat ~/.claude/mcp.json | grep -i ahrefs
- Ahrefs MCP must be registered at user scope (not project scope) to work in subagents