Backlinks Mcp

SEO MCP

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

中文

概述

此服务提供用于获取 Ahrefs SEO 数据的 API。它会处理整个流程，包括解决 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 .
   # Or
   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（字符串）：要分析的域名（例如 "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（字符串）：种子关键词
• country（字符串）：国家代码（默认值："us"）
• search_engine（字符串）：搜索引擎（默认值："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（字符串）：要分析的域名或 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

工作原理

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

故障排除

• CapSolver API 密钥错误：检查 CAPSOLVER_API_KEY 环境变量
• 速率限制：降低请求频率
• 无结果：Ahrefs 可能尚未收录该域名
• 其他问题：请参阅 GitHub 仓库

许可证

MIT 许可证 - 参见 LICENSE 文件