SEO MCP
基于Ahrefs数据的MCP（模型控制协议）SEO工具服务。包括反向链接分析、关键字研究、流量估计等功能。
概述
该服务提供了一个API来从Ahrefs检索SEO数据。它处理整个过程，包括解决验证码、身份验证和数据检索。缓存结果以提高性能并降低API成本。
此MCP服务仅用于教育目的。请不要滥用它。这个项目的灵感来自 @哥飞社群.特性
- 🔍 反向链接分析
- 获取任何域的详细反向链接数据 - 查看域评级、锚文本和链接属性 - 过滤教育和政府领域
- 🎯 关键词研究
- 从种子关键字生成关键字创意 - 获取关键字难度分数 - 查看搜索量和趋势
- 📊 流量分析
- 估计网站流量 - 查看交通历史和趋势 - 分析热门页面和国家分布 - 跟踪关键字排名
- 🚀 性能优化
- 使用CapSolver自动求解验证码 - 响应缓存
安装
先决条件
- Python 3.10或更高版本
- CapSolver帐户和API密钥(在这里注册)
从PyPI安装
pip install seo-mcp或使用 uv:
uv pip install seo-mcp手动安装
- 克隆存储库：
git clone https://github.com/cnych/seo-mcp.git
cd seo-mcp- 安装依赖项：
pip install -e .
# Or
uv pip install -e .- 设置CapSolver API键：
export CAPSOLVER_API_KEY="your-capsolver-api-key"用法
运行服务
您可以通过以下方式运行该服务：
在游标IDE中使用
在光标设置中，切换到MCP选项卡，单击 +Add new global MCP server 按钮，然后输入：
{
"mcpServers": {
"SEO MCP": {
"command": "uvx",
"args": ["--python", "3.10", "seo-mcp"],
"env": {
"CAPSOLVER_API_KEY": "CAP-xxxxxx"
}
}
}
}您还可以创建 .cursor/mcp.json 项目根目录中的文件，内容相同。
api参考
该服务提供以下MCP工具：
get_backlinks_list(domain: str)
获取域名的反向链接。
参数：
domain（string）：要分析的域（例如“example.com”）
退货：
{
"overview": {
"domainRating": 76,
"backlinks": 1500,
"refDomains": 300
},
"backlinks": [
{
"anchor": "Example link",
"domainRating": 76,
"title": "Page title",
"urlFrom": "https://referringsite.com/page",
"urlTo": "https://example.com/page",
"edu": false,
"gov": false
}
]
}keyword_generator(keyword: str, country: str = "us", search_engine: str = "Google")
生成关键字创意。
参数：
keyword（string）：种子关键字country（string）：国家代码（默认：“us”）search_engine（string）：搜索引擎（默认：“Google”）
退货：
[
{
"keyword": "Example keyword",
"volume": 1000,
"difficulty": 45,
"cpc": 2.5
}
]get_traffic(domain_or_url: str, country: str = "None", mode: str = "subdomains")
获取流量估计。
参数：
domain_or_url（string）：要分析的域或URLcountry（字符串）：国家筛选器（默认值：“无”）mode（string）：分析模式（“子域”或“精确”）
退货：
{
"traffic_history": [...],
"traffic": {
"trafficMonthlyAvg": 50000,
"costMontlyAvg": 25000
},
"top_pages": [...],
"top_countries": [...],
"top_keywords": [...]
}keyword_difficulty(keyword: str, country: str = "us")
获取关键字难度分数。
参数：
keyword（string）：要分析的关键字country（string）：国家代码（默认：“us”）
退货：
{
"difficulty": 45,
"serp": [...],
"related": [...]
}发展
发展：
git clone https://github.com/cnych/seo-mcp.git
cd seo-mcp
uv sync运作原理
- 用户通过MCP发送请求
- 该服务使用CapSolver解决Cloudflare旋转栅门验证码问题
- 该服务从Ahrefs获取身份验证令牌
- 该服务检索请求的SEO数据
- 服务处理并返回格式化的结果
故障排除
- CapSolver API密钥错误：检查
CAPSOLVER_API_KEY环境变量 - 速率限制：减少请求频率
- 没有结果：Ahrefs可能不会为该域编制索引
- 其他问题：参见
许可证
MIT许可证-请参阅许可证文件