Backlinks MCP

SEO MCP

基于Ahrefs数据的MCP（模型控制协议）SEO工具服务。包括反向链接分析、关键字研究、流量估计等功能。

中文

概述

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

此MCP服务仅用于教育目的。请不要滥用它。这个项目的灵感来自 @哥飞社群.

特性

• 🔍 反向链接分析

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

• 🎯 关键词研究

- 从种子关键字生成关键字创意 - 获取关键字难度分数 - 查看搜索量和趋势

• 📊 流量分析

- 估计网站流量 - 查看交通历史和趋势 - 分析热门页面和国家分布 - 跟踪关键字排名

• 🚀 性能优化

- 使用CapSolver自动求解验证码 - 响应缓存

安装

先决条件

• 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

1. 安装依赖项：

   pip install -e .
   # Or
   uv pip install -e .

1. 设置CapSolver API键：

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

用法

运行服务

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

在游标IDE中使用

在光标设置中，切换到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 （字符串）：国家筛选器（默认值：“无”）
• mode （string）：分析模式（“子域”或“精确”）

退货：

{
  "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旋转栅门验证码问题
3. 该服务从Ahrefs获取身份验证令牌
4. 该服务检索请求的SEO数据
5. 服务处理并返回格式化的结果

故障排除

• CapSolver API密钥错误：检查 CAPSOLVER_API_KEY 环境变量
• 速率限制：减少请求频率
• 没有结果：Ahrefs可能不会为该域编制索引
• 其他问题：参见

许可证

MIT许可证-请参阅许可证文件