SEO Ahrefs
Businessseo-ahrefsSEO Ahrefs is an Agent Skill for business published in the AgriciDaniel/claude-seo repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Ahrefs API analyst (extension). Reads referring domains, backlinks, organic keywords, and content explorer data via the official @ahrefs/[email protected] server. Pairs with seo-backlinks for multi-source confidence weighting.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/AgriciDaniel/claude-seo/blob/HEAD/extensions/ahrefs/skills/seo-ahrefs/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/seo-ahrefs, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
seo-ahrefs
Live Ahrefs data via the official @ahrefs/[email protected] server.
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 Spam Score 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
python3 scripts/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.