How to use it
- Hit Copy SKILL.md — or use the Claude Code line below to get every file.
- Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
ChatGPT: make a Project and paste it into Instructions.
Neither? Paste it at the top of a new chat — it works for that chat. - Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit AgriciDaniel/claude-seo/extensions/ahrefs/skills/seo-ahrefs#main ~/.claude/skills/seo-ahrefsFor one project only, change the path to .claude/skills/seo-ahrefs. This skill also uses dataforseo_costs.py — copying SKILL.md alone won't be enough. See the folder on GitHub.
Not working?
- Check which app you pasted it into — the steps above name the right one.
- Some skills need the paid tier of Claude or ChatGPT.
Paste into Claude, ChatGPT or Cursor.
Show the full text54 lines
seo-ahrefs
Live Ahrefs data via the tested @ahrefs/[email protected] server.
Package check (2026-07-10): verify the current Ahrefs MCP package source before changing this tested version.
Prerequisites
- Run
extensions/ahrefs/install.sh(Linux/macOS) orinstall.ps1(Windows) before using this skill. - An Ahrefs API token (https://ahrefs.com/api).
- Node 18+ on
$PATHfor the MCP server.
Before calling any Ahrefs tool, verify the MCP is connected by checking that any Ahrefs MCP tool is available in this session. If tools are not available, tell the user the extension is not installed and provide the install command above.
Routing
| Command | Action |
|---|---|
/seo ahrefs metrics <url> |
Domain / URL rating, referring domain count, organic traffic estimate |
/seo ahrefs backlinks <url> |
Top referring domains, anchor distribution, follow/nofollow ratio |
/seo ahrefs organic <url> |
Organic keywords, ranking distribution, traffic by country |
/seo ahrefs content <topic> |
Content Explorer top results, social shares, referring domains |
Output conventions
- Cite the data source on every metric: "Ahrefs (live, confidence 1.00)".
- When Ahrefs and Moz disagree on the same metric, trust Ahrefs and note the discrepancy in the report.
- Toxic link assessment: combine Ahrefs backlink quality signals with the existing seo-backlinks Common Crawl + verify crawler signals.
Cross-skill delegation
- For multi-source confidence weighting across Moz + Bing + Common Crawl + Ahrefs, hand back to
seo-backlinks. - For SERP-feature analysis where Ahrefs and DataForSEO overlap, prefer DataForSEO for live SERP data.
Cost guardrails
Ahrefs API usage is metered per unit. Before running a batch (>= 50 URLs):
- Estimate cost with
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py(the cost-tracker module is generic and supports Ahrefs unit accounting). - Surface the estimate to the orchestrator.
- Log actual cost after each call.
This is the same workflow the seo-dataforseo skill uses.
| 1 | |
| 2 | name seo-ahrefs |
| 3 | description Ahrefs API analyst (extension). Reads referring domains, backlinks, organic keywords, and content explorer data via the tested @ahrefs/[email protected] server. Pairs with seo-backlinks for multi-source confidence weighting. |
| 4 | metadata |
| 5 | version "2.3.1" |
| 6 | compatibility "Tested with @ahrefs/[email protected] (installed by extensions/ahrefs/install.sh)." |
| 7 | |
| 8 | |
| 9 | # seo-ahrefs |
| 10 | |
| 11 | Live Ahrefs data via the tested `@ahrefs/[email protected]` server. |
| 12 | Package check (2026-07-10): verify the current Ahrefs MCP package source before changing this tested version. |
| 13 | |
| 14 | ## Prerequisites |
| 15 | |
| 16 | Run `extensions/ahrefs/install.sh` (Linux/macOS) or `install.ps1` (Windows) before using this skill. |
| 17 | An Ahrefs API token (https://ahrefs.com/api). |
| 18 | Node 18+ on `$PATH` for the MCP server. |
| 19 | |
| 20 | Before calling any Ahrefs tool, verify the MCP is connected by checking |
| 21 | that any Ahrefs MCP tool is available in this session. If tools are |
| 22 | not available, tell the user the extension is not installed and |
| 23 | provide the install command above. |
| 24 | |
| 25 | ## Routing |
| 26 | |
| 27 | | Command | Action | |
| 28 | |---|---| |
| 29 | | `/seo ahrefs metrics <url>` | Domain / URL rating, referring domain count, organic traffic estimate | |
| 30 | | `/seo ahrefs backlinks <url>` | Top referring domains, anchor distribution, follow/nofollow ratio | |
| 31 | | `/seo ahrefs organic <url>` | Organic keywords, ranking distribution, traffic by country | |
| 32 | | `/seo ahrefs content <topic>` | Content Explorer top results, social shares, referring domains | |
| 33 | |
| 34 | ## Output conventions |
| 35 | |
| 36 | Cite the data source on every metric: "Ahrefs (live, confidence 1.00)". |
| 37 | When Ahrefs and Moz disagree on the same metric, trust Ahrefs and note the discrepancy in the report. |
| 38 | Toxic link assessment: combine Ahrefs backlink quality signals with the existing seo-backlinks Common Crawl + verify crawler signals. |
| 39 | |
| 40 | ## Cross-skill delegation |
| 41 | |
| 42 | For multi-source confidence weighting across Moz + Bing + Common Crawl + Ahrefs, hand back to `seo-backlinks`. |
| 43 | For SERP-feature analysis where Ahrefs and DataForSEO overlap, prefer DataForSEO for live SERP data. |
| 44 | |
| 45 | ## Cost guardrails |
| 46 | |
| 47 | Ahrefs API usage is metered per unit. Before running a batch (>= 50 URLs): |
| 48 | |
| 49 | Estimate cost with `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py` (the cost-tracker module is generic and supports Ahrefs unit accounting). |
| 50 | Surface the estimate to the orchestrator. |
| 51 | Log actual cost after each call. |
| 52 | |
| 53 | This is the same workflow the seo-dataforseo skill uses. |
| 54 |
Discussion
Alternatives
Also in SEO & keywordsBacklink Profile AnalysisBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.Claude opus as SEO auditorAct as Claude Opus, an expert SEO auditor, analyzing and optimizing websites for improved search engine performance.Baidu SEO SpecialistExpert Baidu search optimization specialist focused on Chinese search engine ranking, Baidu ecosystem integration, ICP compliance, Chinese keyword research, and mobile-first indexing for the China market.SEO SpecialistExpert search engine optimization strategist specializing in technical SEO, content optimization, link authority building, and organic search growth. Drives sustainable traffic through data-driven search strategies.