SEO MCP

一个基于 Ahrefs 数据的 MCP (模型控制协议) SEO 工具服务。包括反向链接分析、关键词研究、流量预估等功能。

中文

概述

此服务提供一个 API 来从 Ahrefs 检索 SEO 数据。它处理整个过程，包括解决 CAPTCHA、身份验证和数据检索。结果会被缓存以提高性能并降低 API 成本。

此 MCP 服务仅用于教育目的。请勿滥用。此项目灵感来源于 @哥飞社群。

功能

• 🔍 反向链接分析

  • 获取任何域名的详细反向链接数据
  • 查看域名评分、锚文本和链接属性
  • 过滤教育和政府域名

• 🎯 关键词研究

  • 从种子关键词生成关键词创意
  • 获取关键词难度评分
  • 查看搜索量和趋势

• 📊 流量分析

  • 预估网站流量
  • 查看流量历史和趋势
  • 分析热门页面和国家/地区分布
  • 跟踪关键词排名

• 🚀 性能优化

  • 使用 CapSolver 自动解决 CAPTCHA
  • 响应缓存

安装

前提条件

• Python 3.10 或更高版本
• CapSolver 帐户和 API 密钥 (在此注册)

从 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 密钥：

   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 (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): 要分析的域名或 URL
• country (string): 国家/地区过滤器 (默认: "None")
• mode (string): 分析模式 ("subdomains" 或 "exact")

返回值：

{
  "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

工作原理

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

故障排除

• CapSolver API 密钥错误：检查 CAPSOLVER_API_KEY 环境变量
• 速率限制：降低请求频率
• 没有结果：该域名可能未被 Ahrefs 索引
• 其他问题：请参阅 GitHub 存储库

许可证

MIT 许可证 - 请参阅 LICENSE 文件