🚀 SEO MCP 工具服务基于 Ahrefs 数据
这是一个基于 Ahrefs 数据支持的 Model Control Protocol (MCP) 工具服务，可提供 SEO 数据获取功能。它能实现反向链接分析、关键词研究、流量估算等，为 SEO 工作者提供了强大的支持。
English
🚀 快速开始
此服务为从 Ahrefs 获取 SEO 数据提供了 API 接口，涵盖了解决 CAPTCHA、身份验证和数据获取的整个流程。并且，结果会被缓存以提高性能并降低成本。
⚠️ 重要提示
此 MCP 工具仅供教育用途使用。请勿滥用本工具。该项目灵感来源于
@哥飞社群。
✨ 主要特性
- 🔍 反向链接分析
- 获取任意域名的详细反向链接数据。
- 查看域名评分、锚文本和链接属性。
- 过滤教育类及政府类域名。
- 🎯 关键词研究
- 根据种子关键词生成关键词建议。
- 获取关键词难度分数。
- 查看搜索量和趋势。
- 📊 流量分析
- 估算网站流量。
- 查看流量历史和趋势。
- 分析热门页面及国家分布。
- 监控关键词排名。
- 🚀 性能优化
- 使用 CapSolver 自动解决 CAPTCHA。
- 响应缓存。
📦 安装指南
先决条件
- Python 3.10 或更高版本。
- CapSolver 账户及 API Key（注册链接）。
从 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 .
# 或者
uv pip install -e .
- 设置
CAPSOLVER_API_KEY环境变量：
export CAPSOLVER_API_KEY="你的 API Key"
💻 使用示例
基础用法
from seo_mcp import MCPClient
client = MCPClient(api_key="你的 Ahrefs API Key", cap_key="你的 CapSolver API Key")
# 获取反向链接数据
backlinks_data = client.get_backlinks(domain="example.com")
# 获取关键词排名数据
keyword_rankings = client.get_keyword_rankings(keyword="SEO", country="us")
# 获取流量数据
traffic_data = client.get_traffic_analysis(url="https://www.example.com")
示例输出
反向链接数据示例：
{
"domain": "example.com",
"backlinks_count": 1234,
"dofollow_backlinks": 890,
"nofollow_backlinks": 345,
"top_backlink_domains": ["www.example1.com", "www.example2.com"]
}
📚 详细文档
开发指南
git clone https://github.com/cnych/seo-mcp.git
cd seo-mcp
uv sync
工作原理
- 用户通过 MCP 发送请求。
- 服务使用 CapSolver 解决 Cloudflare Turnstile CAPTCHA。
- 服务从 Ahrefs 获取身份验证令牌。
- 服务提取所需 SEO 数据。
- 服务处理数据并返回格式化结果。
故障排除
- CapSolver API Key 错误：检查
CAPSOLVER_API_KEY环境变量。 - 速率限制：降低请求频率。
- 无结果：目标域名可能未被 Ahrefs 索引。
- 其他问题：请访问 GitHub 仓库。
📄 许可证
MIT License - 详见 LICENSE 文件