Backlinks MCP

🚀 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

手动安装

1. 克隆仓库：

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

2. 安装依赖项：

pip install -e .
# 或者
uv pip install -e .

3. 设置 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

工作原理

1. 用户通过 MCP 发送请求。
2. 服务使用 CapSolver 解决 Cloudflare Turnstile CAPTCHA。
3. 服务从 Ahrefs 获取身份验证令牌。
4. 服务提取所需 SEO 数据。
5. 服务处理数据并返回格式化结果。

故障排除

• CapSolver API Key 错误：检查 CAPSOLVER_API_KEY 环境变量。
• 速率限制：降低请求频率。
• 无结果：目标域名可能未被 Ahrefs 索引。
• 其他问题：请访问 GitHub 仓库。

📄 许可证

MIT License - 详见 LICENSE 文件