使用说明

项目简介

SEO MCP服务器是一个基于Model Context Protocol (MCP) 实现的后端服务,旨在为大型语言模型(LLM)客户端提供便捷的SEO(搜索引擎优化)工具。它利用Ahrefs强大的SEO数据,通过标准化的MCP协议,让LLM能够轻松调用各种SEO分析功能,例如域名外链分析、关键词挖掘、网站流量预估等。该服务旨在帮助开发者快速构建具备SEO分析能力的LLM应用。

主要功能点

  • 外链分析: 查询指定域名的外链数据,包括外链数量、域名评分、锚文本、链接属性(如是否为教育或政府网站)等,帮助用户评估网站的外部链接质量。
  • 关键词研究: 根据用户提供的种子关键词,生成相关的关键词建议,并提供关键词的搜索量、难度评分等关键指标,辅助用户进行关键词策略规划。
  • 流量分析: 预估网站的流量情况,包括月度平均流量、流量历史趋势、热门页面、国家/地区分布以及热门关键词等,帮助用户了解网站流量概况和用户行为。
  • 关键词难度查询: 查询特定关键词的竞争难度,并提供SERP(搜索引擎结果页面)分析,以及相关关键词推荐,帮助用户评估关键词的优化潜力。

安装步骤

  1. 环境准备: 确保已安装 Python 3.10 或更高版本。
  2. 安装 'seo-mcp':
    • 使用 pip 安装(推荐):
      pip install seo-mcp
    • 或者使用 uv 安装:
      uv pip install seo-mcp
  3. 配置 CapSolver API Key: 本服务依赖 CapSolver 解决验证码。您需要注册 CapSolver 账户 (注册链接) 并获取 API Key。
    • 设置环境变量 'CAPSOLVER_API_KEY' 为您的 API Key:
      export CAPSOLVER_API_KEY="your-capsolver-api-key"

服务器配置

MCP客户端(如 Cursor IDE)需要配置以下信息以连接到 SEO MCP 服务器。以下是 Cursor IDE 的配置示例,您也可以在项目根目录下创建 '.cursor/mcp.json' 文件,填入相同内容:

{
  "mcpServers": {
    "SEO MCP": {
      "command": "uvx",
      "args": ["--python", "3.10", "seo-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "CAP-xxxxxx"  // 这里替换为您的 CapSolver API Key,或者确保已在环境中设置
      }
    }
  }
}

配置参数说明:

  • server name: 'SEO MCP' - 服务器名称,在MCP客户端中用于标识和选择该服务器。
  • command: 'uvx' - 启动服务器的命令。这里假设您已安装 'uv' 并使用虚拟环境。如果直接使用 'python',则命令可能为 'python' 或 'python3'。
  • args: '["--python", "3.10", "seo-mcp"]' - 命令参数。
    • '--python', '3.10': 指定使用的 Python 版本为 3.10。请根据您的实际Python环境调整。
    • 'seo-mcp': 执行 'seo-mcp' 命令来启动服务器,这会调用安装的 'seo-mcp' 包中的 'main' 函数。
  • env: '{"CAPSOLVER_API_KEY": "CAP-xxxxxx"}' - 环境变量配置。
    • 'CAPSOLVER_API_KEY': CapSolver API Key,请务必替换为您的真实 API Key。 也可以选择在系统环境中设置此变量,则此处无需配置。

注意: 请根据您的实际 Python 环境和 CapSolver API Key 进行配置。 如果您没有使用 'uv',可以将 'command' 修改为 'python' (或 'python3'),并移除 '--python' 和 '3.10' 参数。

基本使用方法

  1. 启动服务器: 配置完成后,MCP服务器会在后台运行,监听来自客户端的请求。
  2. 在 MCP 客户端中调用工具: 在支持 MCP 协议的客户端(如 Cursor IDE)中,您可以使用自然语言指令或特定的调用方式来触发 SEO MCP 服务器提供的工具。 例如,在 Cursor 中,您可以尝试:
    • '@SEO MCP get backlinks for example.com' (获取 example.com 的外链)
    • '@SEO MCP keyword generator for keyword "seo tips"' (生成关于 "seo tips" 的关键词建议)
    • '@SEO MCP get traffic for example.com' (获取 example.com 的流量信息)
    • '@SEO MCP keyword difficulty for keyword "long tail keywords"' (查询 "long tail keywords" 的关键词难度)

具体工具的调用方式和参数,请参考仓库的 API Reference 部分或 MCP 客户端的文档。

重要提示: 本服务依赖第三方服务 Ahrefs 和 CapSolver,请合理使用,避免滥用API导致服务不可用或产生额外费用。 本项目仅供学习交流使用,请勿用于非法用途。

信息

分类

商业系统