搜索引擎优化-MCP

Name: 搜索引擎优化-MCP
Author: cnych

作者：cnych189 星标更新：2025-04-14

安装使用来源：spider==github.com

项目介绍

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

手动安装

克隆仓库：

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标签页，点击+添加新的全局MCP服务器按钮，然后输入：

{
  "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": 100,
      "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

工作原理

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

故障排除

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

许可证

MIT许可证 - 详见LICENSE文件