# Ahrefs MCP

In crawl-budget work, Ahrefs Site Audit surfaces **orphans, redirect chains, parameter URLs, and soft 404s** without running your own crawler. Useful when an Ahrefs Site Audit project already exists for the domain.

## Key endpoints

- `site-audit-projects` — list available projects
- `site-audit-issues` — current crawl-budget-relevant issues (redirect chains, broken links, parameter URLs)
- `site-audit-page-explorer` — per-URL issue surfacing
- `site-audit-page-content` — content-level signals (thin content, duplicates)
- `site-explorer-pages-history` — page count over time vs. observed bot crawls

## Example

```
mcp__ahrefs__site-audit-projects()
mcp__ahrefs__site-audit-issues(project_id="<id>")
mcp__ahrefs__site-audit-page-explorer(project_id="<id>")
mcp__ahrefs__site-explorer-pages-history(target="<domain>", history="weekly")
```

## Strengths for this skill

- Pre-computed orphan detection and redirect-chain surfacing.
- Pages-history helps validate "are we crawling pages that don't exist anymore?"
- Cross-reference Ahrefs indexed-page count with server log crawl data to spot indexing gaps.

## Not for this skill when

- **Actual bot behaviour at the origin** — only server access logs show this. Use `scripts/log_parser.py` + `scripts/crawl_budget_analyzer.py`.
- **First-party Googlebot crawl stats** — GSC Coverage / Crawl Stats reports.
- **Naver / Daum / Kakao bot analysis** — Ahrefs covers Googlebot well but underrepresents Korean bots; rely on logs.
- **No Ahrefs project exists for the domain** — fall back to Semrush `siteaudit_research` or OurSEO crawl.
