Backlinks MCP

🚀 SEO MCP Tool Service Based on Ahrefs Data

This is a Model Control Protocol (MCP) tool service for obtaining SEO data, powered by Ahrefs. It offers functions such as backlink analysis, keyword research, and traffic estimation.

English

🚀 Quick Start

This service provides an API interface for fetching SEO data from Ahrefs, covering the entire process including CAPTCHA solving, authentication, and data retrieval. The results are cached to enhance performance and reduce costs.

⚠️ Important Note

This MCP tool is for educational purposes only. Do not misuse this tool. This project is inspired by @哥飞社群.

✨ Features

• 🔍 Backlink Analysis

  • Obtain detailed backlink data for any domain.
  • View domain ratings, anchor texts, and link attributes.
  • Filter educational and government domains.

• 🎯 Keyword Research

  • Generate keyword suggestions based on seed keywords.
  • Get keyword difficulty scores.
  • Check search volume and trends.

• 📊 Traffic Analysis

  • Estimate website traffic.
  • View traffic history and trends.
  • Analyze popular pages and country distribution.
  • Monitor keyword rankings.

• 🚀 Performance Optimization

  • Automatically solve CAPTCHA using CapSolver.
  • Cache responses.

📦 Installation

Prerequisites

• Python 3.10 or higher
• CapSolver account and API Key (Registration Link)

Install from PyPI

pip install seo-mcp

Or use uv:

uv pip install seo-mcp

Manual Installation

1. Clone the repository:

git clone https://github.com/cnych/seo-mcp.git
cd seo-mcp

2. Install dependencies:

pip install -e .
# Or
uv pip install -e .

3. Set the CAPSOLVER_API_KEY environment variable:

export CAPSOLVER_API_KEY="Your API Key"

💻 Usage Examples

Basic Usage

from seo_mcp import MCPClient

client = MCPClient(api_key="Your Ahrefs API Key", cap_key="Your CapSolver API Key")

# Get backlink data
backlinks_data = client.get_backlinks(domain="example.com")

# Get keyword ranking data
keyword_rankings = client.get_keyword_rankings(keyword="SEO", country="us")

# Get traffic data
traffic_data = client.get_traffic_analysis(url="https://www.example.com")

Example Output

Backlink data example:

{
  "domain": "example.com",
  "backlinks_count": 1234,
  "dofollow_backlinks": 890,
  "nofollow_backlinks": 345,
  "top_backlink_domains": ["www.example1.com", "www.example2.com"]
}

📚 Documentation

Development Guide

git clone https://github.com/cnych/seo-mcp.git
cd seo-mcp
uv sync

How It Works

1. Users send requests via MCP.
2. The service uses CapSolver to solve Cloudflare Turnstile CAPTCHA.
3. The service retrieves an authentication token from Ahrefs.
4. The service extracts the required SEO data.
5. The service processes the data and returns formatted results.

Troubleshooting

• CapSolver API Key Error: Check the CAPSOLVER_API_KEY environment variable.
• Rate Limiting: Reduce the request frequency.
• No Results: The target domain may not be indexed by Ahrefs.
• Other Issues: Visit the GitHub repository.

📄 License

MIT License - See the LICENSE file for details.