Ahrefs Automation

Ahrefs Automation

Run Ahrefs SEO analytics directly from Claude Code. Analyze backlink profiles, research keywords, track domain authority over time, audit organic keyword rankings, and batch-analyze multiple URLs without leaving your terminal.

Toolkit docs: composio.dev/toolkits/ahrefs

---

Setup

1. Add the Composio MCP server to your configuration:

   https://rube.app/mcp
   

2. Connect your Ahrefs account when prompted. The agent will provide an authentication link.
3. Most tools require a target (domain or URL) and a country code (ISO 3166-1 alpha-2). Some also require a date in YYYY-MM-DD format.

---

Core Workflows

1. Site Explorer Metrics

Retrieve comprehensive SEO metrics for a domain including backlink counts, referring domains, organic keyword rankings, and traffic estimates.

Tool: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS

Key parameters:

• target (required) -- domain or URL to analyze
• date (required) -- metrics date in YYYY-MM-DD format
• country -- ISO country code (e.g., us, gb, de)
• mode -- scope: exact, prefix, domain, or subdomains (default)
• protocol -- both, http, or https
• volume_mode -- monthly or average

Example prompt: "Get Ahrefs site metrics for example.com as of today in the US"

---

2. Historical Metrics Tracking

Track how a domain's SEO metrics have changed over time for trend analysis and competitive benchmarking.

Tools: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY, AHREFS_DOMAIN_RATING_HISTORY

For full metrics history:

• target (required) -- domain to track
• date_from (required) -- start date in YYYY-MM-DD
• date_to -- end date
• history_grouping -- daily, weekly, or monthly (default)
• select -- columns like date,org_cost,org_traffic,paid_cost,paid_traffic

For Domain Rating (DR) history:

• target (required), date_from (required), date_to, history_grouping

Example prompt: "Show me the monthly Domain Rating history for example.com over the last year"