Ahrefs API analyst

SEO ahrefs

by AgriciDaniel · MIT license · ★ 17,394 on GitHub · updated Sep 11

Ahrefs API analyst (extension). Reads referring domains, backlinks, organic keywords, and content explorer data via the tested @ahrefs/[email protected] server.

---
name: seo-ahrefs
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.
metadata:
  version: "2.3.1"
compatibility: "Tested with @ahrefs/[email protected] (installed by extensions/ahrefs/install.sh)."
---

# 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) or `install.ps1` (Windows) before using this skill.
- An Ahrefs API token (https://ahrefs.com/api).
- Node 18+ on `$PATH` for the MCP server.

Overview

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.

What you get

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 discr
Toxic link assessmentcombine Ahrefs backlink quality signals with the existing seo-backlinks Common Crawl + verify crawler signals.

The SKILL.md below is the copy AgentAlley read and checked. The repo has changed it since; the other files are from commit e77e783.

Manual install (npx, ZIP)

Claude Codenpx skills add AgriciDaniel/claude-seo --skill seo-ahrefs -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/AgriciDaniel/claude-seo/tar.gz/e77e783e38ee \
  | tar -xz -C ~/.claude/skills --strip-components=4 claude-seo-e77e783e38ee/extensions/ahrefs/skills/seo-ahrefs

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/b09260df215bad174955/seo-ahrefs.zip" -OutFile "$env:TEMP\seo-ahrefs.zip"; Expand-Archive "$env:TEMP\seo-ahrefs.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md2.4 KB

Read the files here

AgriciDaniel/e77e7831 file

SKILL.md2.4 KB

SKILL.md

Show the full text54 lines

seo-ahrefs/SKILL.md54 lines · 2.4 KB

PreviewCode

Outline

RawView on GitHub

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) or install.ps1 (Windows) before using this skill.
An Ahrefs API token (https://ahrefs.com/api).
Node 18+ on $PATH for 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	1. 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	2. Surface the estimate to the orchestrator.
51	3. Log actual cost after each call.
52
53	This is the same workflow the seo-dataforseo skill uses.
54