mcpField
S
seo-ahrefs

seo-ahrefs

github.com/infrasity-labsMarketing & growth15084 installsUpdated 17w ago
Repository

About seo-ahrefs

seo-ahrefs is a skill for retrieving live Ahrefs SEO metrics and research through the official `@ahrefs/mcp` server. It guides domain, backlink, organic keyword, and content queries, with source citation and API cost checks for larger batches.

Key features

  1. 01Domain and URL SEO metrics
  2. 02Backlink and anchor analysis
  3. 03Organic keyword and country data
  4. 04Content Explorer result analysis
  5. 05Metric citations and batch cost checks

Use cases

  1. 01Review a domain’s rating and estimated organic traffic
  2. 02Inspect referring domains and follow/nofollow links
  3. 03Compare organic rankings across countries
  4. 04Research top content and social shares

MCP support

Uses the official `@ahrefs/mcp` server to access live Ahrefs data. The skill checks that an Ahrefs MCP tool is available before making calls.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill seo-ahrefs

After installing, type/seo-ahrefsin Claude Code to confirm it loaded.

Details

From the project README

seo-ahrefs

Live Ahrefs data via the official @ahrefs/mcp server.

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

CommandAction
/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):

  1. Estimate cost with python scripts/dataforseo_costs.py (the cost-tracker module is generic and supports Ahrefs unit accounting).
  2. Surface the estimate to the orchestrator.
  3. Log actual cost after each call.

This is the same workflow the seo-dataforseo skill uses.

Comments

Markdown supported