seo-ahrefs-competitors

Installation

$npx skills add lionkiii/claude-seo-skills --skill seo-ahrefs-competitors

Summary

When invoked with a domain, this skill queries Ahrefs to identify competing domains by keyword overlap, surface the top competitors and shared keywords, and identify content gaps by revealing keywords competitors rank for that the target domain doesn't.

SKILL.MD

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). Strip https://, http://, and trailing slashes before passing to Ahrefs tools.

MCP Check

Before proceeding, verify Ahrefs MCP is available:

  1. Use ToolSearch with query +ahrefs
  2. If tools are returned → Ahrefs MCP is available, proceed to Execution
  3. If no tools returned → display the Ahrefs MCP error template from references/mcp-degradation.md and 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