$npx -y skills add AgriciDaniel/claude-seo --skill seo-ahrefsAhrefs API analyst (extension). Reads referring domains, backlinks, organic keywords, and content explorer data via the tested @ahrefs/mcp@0.0.11 server. Pairs with seo-backlinks for multi-source confidence weighting.
| 1 | # seo-ahrefs |
| 2 | |
| 3 | Live Ahrefs data via the tested `@ahrefs/mcp@0.0.11` server. |
| 4 | Package check (2026-07-10): verify the current Ahrefs MCP package source before changing this tested version. |
| 5 | |
| 6 | ## Prerequisites |
| 7 | |
| 8 | - Run `extensions/ahrefs/install.sh` (Linux/macOS) or `install.ps1` (Windows) before using this skill. |
| 9 | - An Ahrefs API token (https://ahrefs.com/api). |
| 10 | - Node 18+ on `$PATH` for the MCP server. |
| 11 | |
| 12 | Before calling any Ahrefs tool, verify the MCP is connected by checking |
| 13 | that any Ahrefs MCP tool is available in this session. If tools are |
| 14 | not available, tell the user the extension is not installed and |
| 15 | provide the install command above. |
| 16 | |
| 17 | ## Routing |
| 18 | |
| 19 | | Command | Action | |
| 20 | |---|---| |
| 21 | | `/seo ahrefs metrics <url>` | Domain / URL rating, referring domain count, organic traffic estimate | |
| 22 | | `/seo ahrefs backlinks <url>` | Top referring domains, anchor distribution, follow/nofollow ratio | |
| 23 | | `/seo ahrefs organic <url>` | Organic keywords, ranking distribution, traffic by country | |
| 24 | | `/seo ahrefs content <topic>` | Content Explorer top results, social shares, referring domains | |
| 25 | |
| 26 | ## Output conventions |
| 27 | |
| 28 | - Cite the data source on every metric: "Ahrefs (live, confidence 1.00)". |
| 29 | - When Ahrefs and Moz disagree on the same metric, trust Ahrefs and note the discrepancy in the report. |
| 30 | - Toxic link assessment: combine Ahrefs backlink quality signals with the existing seo-backlinks Common Crawl + verify crawler signals. |
| 31 | |
| 32 | ## Cross-skill delegation |
| 33 | |
| 34 | - For multi-source confidence weighting across Moz + Bing + Common Crawl + Ahrefs, hand back to `seo-backlinks`. |
| 35 | - For SERP-feature analysis where Ahrefs and DataForSEO overlap, prefer DataForSEO for live SERP data. |
| 36 | |
| 37 | ## Cost guardrails |
| 38 | |
| 39 | Ahrefs API usage is metered per unit. Before running a batch (>= 50 URLs): |
| 40 | |
| 41 | 1. Estimate cost with `claude-seo run dataforseo_costs.py` (the cost-tracker module is generic and supports Ahrefs unit accounting). |
| 42 | 2. Surface the estimate to the orchestrator. |
| 43 | 3. Log actual cost after each call. |
| 44 | |
| 45 | This is the same workflow the seo-dataforseo skill uses. |