SEO MCP 工具服务基于 Ahrefs 数据

这是一个提供 SEO 数据获取的 Model Control Protocol (MCP) 工具服务，基于 Ahrefs 的数据支持。功能包括反向链接分析、关键词研究、流量估算等。

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 文件