# Ahrefs MCP

Use for **top-pages-by-traffic** views on competitor sites, **content decay** candidates on the target, and Korean platform refdomains. Namespace: `mcp__ahrefs__*` / `mcp__claude_ai_Ahrefs__*`.

## Key endpoints

- `site-explorer-top-pages` — pages ranked by traffic for any domain (target or competitor)
- `site-explorer-pages-history` — trend in indexed pages over time (decay signal)
- `site-explorer-pages-by-traffic` — sorted by current traffic
- `site-explorer-pages-by-internal-links` — informs internal-linking opportunities
- `keywords-explorer-overview` / `-related-terms` / `-matching-terms` — topic expansion
- `gsc-pages` — first-party top pages when GSC is connected to the project

## Example

```
mcp__ahrefs__site-explorer-top-pages(target="<competitor>", country="us", limit=100)
mcp__ahrefs__site-explorer-pages-history(target="<target>", history="monthly")
mcp__ahrefs__keywords-explorer-related-terms(keyword="<topic>", country="us", limit=50)
```

## Strengths for this skill

- Best ranked-by-traffic view of competitor content inventory.
- Historical pages-history surfaces decaying content quickly.
- Pairs well with OurSEO crawl (which gives the on-page side).

## Not for this skill when

- **On-page content inventory of the target** — OurSEO `crawl_website` is the ground-truth source.
- **Cannibalization detection** on the target — GSC first-party data is required.
- **Korean Naver content** — Ahrefs underrepresents Naver Blog/Cafe; use `our research naver *` and WebSearch.
