Skill v1.0.0
currentLLM-judged scan90/100version: "1.0.0" name: seo-ahrefs description: Ahrefs 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. metadata: version: "2.4.2" compatibility: "Tested with @ahrefs/mcp@0.0.11 (installed by Hermes plugin/provider setup)."
seo-ahrefs
Live Ahrefs data via the tested @ahrefs/mcp@0.0.11 server. Package check (2026-07-10): verify the current Ahrefs MCP package source before changing this tested version.
Prerequisites
- Run `a compatible Ahrefs MCP server in Hermes 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 provider MCP is not configured in Hermes and provide the install command above.
Routing
| Command | Action | |
|---|---|---|
Use the registered hermes-seo:seo-backlinks workflow with Ahrefs MCP metrics <url>` | Domain / URL rating, referring domain count, organic traffic estimate | |
Use the registered hermes-seo:seo-backlinks workflow with Ahrefs MCP backlinks <url>` | Top referring domains, anchor distribution, follow/nofollow ratio | |
Use the registered hermes-seo:seo-backlinks workflow with Ahrefs MCP organic <url>` | Organic keywords, ranking distribution, traffic by country | |
Use the registered hermes-seo:seo-backlinks workflow with Ahrefs MCP 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
hermes 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.