# Ahrefs MCP

In the KPI framework, Ahrefs owns **backlinks/DR**, contributes alternates for **traffic value** and **visibility**, and provides historical trend series. Namespace: `mcp__ahrefs__*` / `mcp__claude_ai_Ahrefs__*`.

## KPI dimensions served by Ahrefs

| KPI | Endpoint |
|---|---|
| Domain Rating | `site-explorer-domain-rating` |
| DR history (trend) | `site-explorer-domain-rating-history` |
| Backlink count + dofollow ratio | `site-explorer-backlinks-stats` |
| Referring domains (count + trend) | `site-explorer-refdomains-history` |
| Organic traffic estimate | `site-explorer-metrics` |
| Metrics history (trend) | `site-explorer-metrics-history` |
| Top pages traffic distribution | `site-explorer-top-pages` |
| First-party clicks/impressions (if GSC connected) | `gsc-performance-history`, `gsc-positions-history` |

## Example

```
mcp__ahrefs__site-explorer-metrics(target="<domain>")
mcp__ahrefs__site-explorer-metrics-history(target="<domain>", history="weekly")
mcp__ahrefs__site-explorer-domain-rating-history(target="<domain>", history="weekly")
```

## Strengths for this skill

- Backlink dimension is unmatched.
- Trend series are pre-computed — useful for period-over-period KPI charts.
- When GSC is connected to the Ahrefs project, first-party CTR / position history is available.

## Not for this skill when

- **Technical-health KPI** — OurSEO's audit + crawl is deeper.
- **GA4 / on-site engagement KPI** — `our research ga4 *` only.
- **GBP local KPI** — `our collect gbp *` / `our audit local` only.
- **Indexed pages count** — OurSEO `check_index` / GSC Coverage.
