Handles solving Cloudflare Turnstile CAPTCHA automatically to access protected SEO data services.
Provides access to Google's search engine for keyword research, analysis, and SEO optimization through the MCP service.
SEO MCP
A MCP (Model Control Protocol) SEO tool service based on Ahrefs data. Includes features such as backlink analysis, keyword research, traffic estimation, and more.
Overview
This service provides an API to retrieve SEO data from Ahrefs. It handles the entire process, including solving the CAPTCHA, authentication, and data retrieval. The results are cached to improve performance and reduce API costs.
This MCP service is for educational purposes only. Please do not misuse it. This project is inspired by
@哥飞社群
.
Features
🔍 Backlink Analysis
Get detailed backlink data for any domain
View domain rating, anchor text, and link attributes
Filter educational and government domains
🎯 Keyword Research
Generate keyword ideas from a seed keyword
Get keyword difficulty score
View search volume and trends
📊 Traffic Analysis
Estimate website traffic
View traffic history and trends
Analyze popular pages and country distribution
Track keyword rankings
🚀 Performance Optimization
Use CapSolver to automatically solve CAPTCHA
Response caching
Installation
Prerequisites
Python 3.10 or higher
CapSolver account and API key (register here)
Install from PyPI
Or use uv
:
Manual Installation
Clone the repository:
git clone https://github.com/cnych/seo-mcp.git cd seo-mcpInstall dependencies:
pip install -e . # Or uv pip install -e .Set the CapSolver API key:
export CAPSOLVER_API_KEY="your-capsolver-api-key"
Usage
Run the service
You can run the service in the following ways:
Use in Cursor IDE
In the Cursor settings, switch to the MCP tab, click the +Add new global MCP server
button, and then input:
You can also create a .cursor/mcp.json
file in the project root directory, with the same content.
API Reference
The service provides the following MCP tools:
get_backlinks_list(domain: str)
Get the backlinks of a domain.
Parameters:
domain
(string): The domain to analyze (e.g. "example.com")
Returns:
keyword_generator(keyword: str, country: str = "us", search_engine: str = "Google")
Generate keyword ideas.
Parameters:
keyword
(string): The seed keywordcountry
(string): Country code (default: "us")search_engine
(string): Search engine (default: "Google")
Returns:
get_traffic(domain_or_url: str, country: str = "None", mode: str = "subdomains")
Get the traffic estimation.
Parameters:
domain_or_url
(string): The domain or URL to analyzecountry
(string): Country filter (default: "None")mode
(string): Analysis mode ("subdomains" or "exact")
Returns:
keyword_difficulty(keyword: str, country: str = "us")
Get the keyword difficulty score.
Parameters:
keyword
(string): The keyword to analyzecountry
(string): Country code (default: "us")
Returns:
Development
For development:
How it works
The user sends a request through MCP
The service uses CapSolver to solve the Cloudflare Turnstile CAPTCHA
The service gets the authentication token from Ahrefs
The service retrieves the requested SEO data
The service processes and returns the formatted results
Troubleshooting
CapSolver API key error:Check the
CAPSOLVER_API_KEY
environment variableRate limiting:Reduce request frequency
No results:The domain may not be indexed by Ahrefs
Other issues:See GitHub repository
License
MIT License - See LICENSE file
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A MCP server for retrieving backlink information for any domain(SEO).
Related MCP Servers
- AsecurityFlicenseAqualityAn MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.Last updated -11143
- -securityFlicense-qualityAn MCP server that integrates with SerpApi to retrieve search results from multiple search engines including Google, Bing, Yahoo, and others, enabling fast access to both live and archived search data.Last updated -15
- -securityFlicense-qualityAn MCP server that enables searching and retrieving content from Confluence documentation systems, providing capabilities for both document searches and full page content retrieval.Last updated -1
- AsecurityFlicenseAqualityAn MCP server that enables interaction with Markdown knowledge bases, allowing users to search and retrieve content by tags, text, URL, or date range from their local markdown files.Last updated -779