Noureddine RAMDI / dataseo-mcp: wrapping Ahrefs SEO data as AI assistant tools via CAPTCHA bypass

Created Sat, 23 May 2026 20:41:14 +0000 Modified Sat, 23 May 2026 20:41:27 +0000
1048 Words
github-stars python mcp seo ahrefs captcha ai-assistant

egebese/seo-research-mcp

DataSEO MCP is not your typical SEO tool. It reverse-engineers free Ahrefs SEO data behind CAPTCHA walls and surfaces it as a suite of structured MCP tools for AI assistants. This lets AI-powered IDEs like Claude Desktop or Cursor query backlink profiles, keyword difficulty, and traffic estimates as if they were native commands — all wrapped in a Python MCP server. It’s a clever bridge between a popular SEO workflow and the emerging world of AI-assisted coding environments.

what dataseo-mcp does and its architecture

At its core, dataseo-mcp is a Python-based MCP (Model Context Protocol) server that exposes nine SEO research tools powered by Ahrefs free data. Ahrefs typically protects its data behind CAPTCHA challenges, but this repo leverages CAPTCHA-solving providers like CapSolver and Anti-Captcha to automate bypassing those barriers.

The MCP server implements tools covering a broad range of SEO needs:

  • backlink analysis
  • keyword generation
  • traffic estimation
  • keyword difficulty
  • AI search queries
  • domain overview
  • domain comparison
  • backlink opportunities
  • SEO content briefs

The last two features, especially SEO content briefs and AI search queries, integrate AI-assisted capabilities via OpenRouter, enabling query planning and content generation to complement raw SEO metrics.

Architecturally, the repo separates concerns cleanly across several modules:

  • Services layer: Core business logic for each MCP tool.
  • Schemas: Data validation and typing to ensure structured requests and responses.
  • CAPTCHA handling: Interfaces with CapSolver and Anti-Captcha APIs for solving CAPTCHA challenges.
  • Ahrefs adapters: Scraping and parsing Ahrefs free data endpoints.
  • AI query generation: Uses OpenRouter API to support AI-assisted queries.
  • Caching modules: To store and reuse results where possible, reducing redundant CAPTCHA solving and scraping.

The server is designed to be run with Python 3.10+, using uvx as the entrypoint. It integrates smoothly with MCP-compatible AI IDEs such as Claude Desktop, Cursor, Claude Code, and VS Code, allowing developers to call SEO research tools from within their coding environment.

technical strengths and design tradeoffs

One of the standout strengths of dataseo-mcp is its practical approach to exposing SEO data behind CAPTCHA protections. By integrating CAPTCHA-solving providers, it automates what would otherwise be a manual, rate-limited, and error-prone process.

The modular design helps isolate each concern, making the codebase manageable despite the complexity of dealing with web scraping, CAPTCHA solving, and AI query generation. The use of schemas for request/response validation adds robustness to the MCP interface.

On the AI side, leveraging OpenRouter for query planning and content briefs enriches the raw SEO data with intelligent insights. This hybrid approach — combining scraped metrics with AI query generation — offers a richer developer experience.

However, there are clear tradeoffs:

  • Dependency on CAPTCHA-solving services: This introduces external costs, potential latency, and a reliability bottleneck. If the CAPTCHA provider’s API changes or is rate-limited, the server’s functionality degrades.

  • Unofficial scraping of Ahrefs free data: This approach is inherently brittle. Changes to Ahrefs’ front-end or CAPTCHA mechanisms could break the adapters.

  • Caching mitigates some load but can’t eliminate scraping fragility: Cached results reduce repeated CAPTCHA hits but fresh data requires live scraping.

  • AI-assisted features depend on OpenRouter API: Users need to supply API keys, which adds setup complexity and potential limits.

The code quality is surprisingly clean for a scraping-heavy project. The repo follows a clear separation of concerns, uses modern Python typing and validation, and aligns well with MCP standards, which is not trivial given the multi-API integration.

quick start

To install dataseo-mcp, the recommended approach is via uvx with Python 3.10:

uvx --python 3.10 dataseo-mcp

For local development, clone the repo and run:

git clone https://github.com/egebese/dataseo-mcp.git
cd dataseo-mcp
uv sync
uv run dataseo-mcp

The legacy seo-mcp command remains as a compatibility alias.

To configure the MCP server for AI IDEs, environment variables for CAPTCHA provider API keys are required. For example, in Claude Desktop or Cursor, the config looks like this:

{
  "mcpServers": {
    "dataseo": {
      "command": "uvx",
      "args": ["--python", "3.10", "dataseo-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_KEY",
        "ANTICAPTCHA_API_KEY": "YOUR_ANTICAPTCHA_KEY",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY"
      }
    }
  }
}

Only one CAPTCHA provider key is mandatory; add the OpenRouter key if you want AI-assisted query generation or content briefs.

For VS Code MCP integration, a minimal config example is:

{
  "servers": {
    "dataseo": {
      "command": "uvx",
      "args": ["--python", "3.10", "dataseo-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_KEY"
      }
    }
  }
}

This setup allows seamless querying of SEO metrics through your AI assistant embedded in your IDE.

verdict

dataseo-mcp fits a niche but practical use case: SEO professionals and developers who already use Ahrefs and want to integrate SEO research directly into AI-powered coding assistants. It effectively automates the tedious parts of scraping protected SEO data and wraps them as structured tools.

The tradeoff is clear — reliance on CAPTCHA-solving services and scraping means potential fragility and external cost. It’s not a turnkey SEO platform but a tool that extends existing workflows into the AI assistant space.

If you’re comfortable with API keys, scraping tradeoffs, and want to prototype or build AI-assisted SEO tooling inside IDEs like Claude or VS Code, dataseo-mcp is worth exploring. Its modular design and clean codebase also make it a reasonable starting point for customization or extension.

For others looking for more stable, officially supported SEO APIs, this approach may feel brittle and require maintenance.

Overall, dataseo-mcp is a solid example of bridging proprietary web data with AI tooling, illustrating both the possibilities and the practical tradeoffs in this space.

→ GitHub Repo: egebese/seo-research-mcp ⭐ 181 · Python