Backlinks (Ahrefs)

🚀 SEO MCP

An SEO tool service based on Ahrefs data. It offers features such as backlink analysis, keyword research, and traffic estimation.

English

🚀 Quick Start

This service provides an API to fetch SEO data from Ahrefs, covering the entire process including CAPTCHA solving, authentication, and data extraction. Results are cached to optimize performance and reduce costs.

⚠️ Important Note

This MCP service is for educational purposes only. Please do not misuse it. This project is inspired by @哥飞社群.

✨ Features

• 🔍 Backlink Analysis

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

• 🎯 Keyword Research

  • Generate keyword ideas from seed keywords.
  • Obtain keyword difficulty scores.
  • Check search volumes and trends.

• 📊 Traffic Analysis

  • Estimate website traffic.
  • Get information on top pages, top countries, and regions.

• 💡 Performance Optimization

  • Solve Cloudflare Turnstile CAPTCHA.
  • Provide detailed SEO data output.

📦 Installation

Prerequisites

• Python 3.6+

Method 1: Install from PyPI

pip install seo-mcp

Method 2: Manual Installation

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

💻 Usage Examples

Run the Service

# Start the service on port 8000 by default
uv run .

# Or specify the configuration file path
uv run --config ./config.yaml

API Interfaces

Backlink Analysis

from seo_mcp import SeoMcp

client = SeoMcp(api_key="your_api_key")
result = client.link_analysis(domain="example.com")
print(result)

Keyword Research

from seo_mcp import SeoMcp

client = SeoMcp(api_key="your_api_key")
result = client.keyword_research(keyword="example", country="us")
print(result)

🔧 Technical Details

Development

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

How It Works

1. Users send requests through MCP.
2. The service uses CapSolver to solve Cloudflare Turnstile CAPTCHA.
3. Obtain an authentication token from Ahrefs.
4. Extract the required SEO data.
5. Process and return formatted results.

Troubleshooting

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

📄 License

This project is under the MIT License - see the LICENSE file for details.