AI导哈

SEO数据分析工具

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

  • by cnych
  • Python
  • 本地部署
  • 260 星标
  • 更新于
在 GitHub 查看 cnych/seo-mcp

使用说明

SEO MCP

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

中文

概述

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

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

特性

  • 🔍 反向链接分析

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

  • 🎯 关键词研究

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

  • 📊 流量分析

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

  • 🚀 性能优化

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

安装

先决条件

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

用法

运行服务

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

在游标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可能不会为该域编制索引
  • 其他问题：参见 GitHub存储库

许可证

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

相关 MCP