# Ahrefs MCP

In the reporting dashboard, Ahrefs is the source for **backlinks**, **DR + history**, **traffic-value alternate**, **Brand Radar AI visibility**, and **per-country traffic** breakouts.

Namespace: `mcp__ahrefs__*` / `mcp__claude_ai_Ahrefs__*`.

## Tools used in dashboard sections

| Section | Endpoint |
|---|---|
| Backlinks / DR | `site-explorer-domain-rating`, `site-explorer-backlinks-stats` |
| DR trend chart | `site-explorer-domain-rating-history` |
| Refdomains trend chart | `site-explorer-refdomains-history` |
| Traffic / visibility snapshot (alternate) | `site-explorer-metrics` |
| Traffic / visibility trend (alternate) | `site-explorer-metrics-history` |
| AI search visibility / SOV | `brand-radar-sov-overview`, `brand-radar-sov-history` |
| Cited pages in AI answers | `brand-radar-cited-pages`, `brand-radar-cited-domains` |
| Per-country traffic distribution | `web-analytics-countries`, `site-explorer-metrics-by-country` |
| First-party clicks/impressions (if connected) | `gsc-performance-history`, `gsc-pages-history` |

## Example

```
mcp__ahrefs__site-explorer-metrics(target="<domain>")
mcp__ahrefs__site-explorer-metrics-history(target="<domain>", history="weekly")
mcp__ahrefs__brand-radar-sov-overview(brand="<brand>")
mcp__ahrefs__web-analytics-countries(domain="<domain>")
```

## Strengths for the dashboard

- **Pre-computed trend series** — saves the dashboard from synthesizing trends from point-in-time pulls.
- **Brand Radar is Ahrefs-only** — required for AI-visibility report sections.
- Traffic value in **USD cents** — divide by 100 for USD when rendering.

## Reporting rule

Whenever an Ahrefs endpoint feeds a section, list it in the report's **Sources** subsection (e.g., `Backlinks / DR: Ahrefs site-explorer-domain-rating`).

## Not for this skill when

- **First-party clicks / impressions / CTR** — prefer GSC over `gsc-*` Ahrefs alternates unless Ahrefs project is already configured.
- **Technical health section** — OurSEO `audit_page` / `audit tech`.
- **GA4 sessions / conversions** — `our research ga4 *`.
- **GBP local KPIs** — `our collect gbp *` / `our audit local`.

Notes:
- Ahrefs data has ~24h freshness lag.
- Historical data window depends on Ahrefs subscription tier — fall back to point-in-time + manual snapshot history if needed.

Reference: `mcp__ahrefs__doc` once per session.
