SEO MCP

April 14, 2025 · View on GitHub

一个基于 Ahrefs 数据的 MCP（Model Control Protocol）SEO 工具服务。包含反向链接分析、关键词研究、流量估算等功能。

English

概述

该服务提供了从 Ahrefs 获取 SEO 数据的 API。它处理整个过程，包括验证码解决、认证和数据检索。结果会被缓存以提高性能并减少 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 .
# 或
uv pip install -e .

设置 CapSolver API 密钥：

export CAPSOLVER_API_KEY="your-capsolver-api-key"

使用方法

运行服务

您可以通过以下方式运行服务：

在 Cursor IDE 中使用

在 Cursor 设置中，切换到 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（字符串）：要分析的域名（例如："example.com"）

返回：

{
  "overview": {
    "domainRating": 76,
    "backlinks": 1500,
    "refDomains": 300
  },
  "backlinks": [
    {
      "anchor": "示例链接",
      "domainRating": 76,
      "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（字符串）：种子关键词
country（字符串）：国家代码（默认："us"）
search_engine（字符串）：搜索引擎（默认："Google"）

返回：

[
  {
    "keyword": "示例关键词",
    "volume": 1000,
    "difficulty": 45,
    "cpc": 2.5
  }
]

`get_traffic(domain_or_url: str, country: str = "None", mode: str = "subdomains")`

获取流量估算。

参数：

domain_or_url（字符串）：要分析的域名或 URL
country（字符串）：国家筛选（默认："None"）
mode（字符串）：分析模式（"subdomains" 或 "exact"）

返回：

{
  "traffic_history": [...],
  "traffic": {
    "trafficMonthlyAvg": 50000,
    "costMontlyAvg": 25000
  },
  "top_pages": [...],
  "top_countries": [...],
  "top_keywords": [...]
}

`keyword_difficulty(keyword: str, country: str = "us")`

获取关键词难度评分。

参数：

keyword（字符串）：要分析的关键词
country（字符串）：国家代码（默认："us"）

返回：

{
  "difficulty": 45,
  "serp": [...],
  "related": [...]
}

开发

对于开发：

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

工作原理

用户通过 MCP 发送请求
服务使用 CapSolver 解决 Cloudflare Turnstile 验证码
从 Ahrefs 获取认证令牌
检索请求的 SEO 数据
处理并返回格式化结果

故障排除

CapSolver API 密钥错误：检查 CAPSOLVER_API_KEY 环境变量
速率限制：减少请求频率
无结果：域名可能未被 Ahrefs 收录
其他问题：查看 GitHub 仓库

许可证

MIT 许可证 - 详见 LICENSE 文件