home / mcp / seo research mcp server

SEO Research MCP Server

Provides SEO data (backlinks, keywords, traffic, and difficulty) via MCP integration with Ahrefs data sources.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "egebese-seo-research-mcp": {
      "command": "uvx",
      "args": [
        "--python",
        "3.10",
        "seo-mcp"
      ],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

SEO Research MCP brings powerful SEO research capabilities directly into your AI coding environment. By connecting your IDE to Ahrefs data through the MCP framework, you can research backlinks, generate keyword ideas, analyze traffic, and assess keyword difficulty without leaving your editor. This speeds up your SEO-informed development and content planning workflows.

How to use

You use the SEO Research MCP by enabling one of the provided MCP connections in your IDE. Once activated, you can issue prompts in your editor to query backlink data, generate keyword ideas, estimate traffic, or check keyword difficulty. The tool coordinates with CapSolver for CAPTCHA handling and retrieves data from Ahrefs, returning formatted results directly in your coding workspace.

Typical usage patterns include:

Ask for backlinks for a target domain to understand its link profile and referrer domains
Seed keyword ideas by providing a starting term to discover related keywords and volumes
Query traffic estimates for a domain or URL to gauge audience reach and top pages
Check keyword difficulty to gauge ranking effort before content creation

Example workflows

Backlink research workflow: you prompt the editor with a request like “Show me backlinks for competitor.com” and receive a structured list of anchors, titles, URLs, and domain ratings.

Keyword ideation workflow: you ask for related keywords to a seed term and review a set of keyword suggestions with search volumes and difficulty scores.

Traffic analysis workflow: you request monthly traffic and top pages for a domain, then examine top countries and keywords to inform content strategy.

Security and usage notes

This MCP interacts with third-party services and requires an API key for CAPTCHA solving. Keep your CAPSOLVER_API_KEY secure and avoid sharing it in public environments. Ensure you comply with all third-party terms of service when using Ahrefs data and CAPTCHA solving services.

Troubleshooting tips

If you encounter a CapSolver API key error, verify that CAPSOLVER_API_KEY is correctly configured in your MCP environment.

If you hit rate limits, pause requests briefly and reduce the frequency of queries in your editor prompts.

If no results are returned for a domain, it may not be indexed in Ahrefs or the data source could be temporarily unavailable.

Available tools

get_backlinks_list

Fetches backlink data for a domain, including domain rating, anchor text, and related URLs.

keyword_generator

Generates keyword ideas from a seed keyword with optional country and search engine context.

get_traffic

Estimates monthly traffic for a domain or URL and provides top pages and country distribution.

keyword_difficulty

Computes a keyword difficulty score and returns a SERP breakdown.