SE Ranking MCP Server

SE排名MCP服务器

此模型上下文协议（MCP）服务器将AI助手连接到 SE排名 SEO数据和项目管理API。它支持对以下内容进行自然语言查询：

• 关键词研究和竞争分析
• 反向链接分析和监控
• 域名流量和排名洞察
• 网站审计和技术SEO
• AI搜索可见性跟踪
• 项目和排名跟踪管理

先决条件

在开始之前，请确保您已准备好以下软件和帐户：

• SE排名账户：您需要一个活动的SE Ranking帐户才能生成API令牌。如果你没有，你可以 在这里注册.
• 码头工人：一个用于在容器中开发、运输和运行应用程序的平台。如果你没有，你可以 .
• Git：一个免费和开源的分布式版本控制系统。你可以从Git官方网站下载。

API令牌

此MCP服务器支持两种类型的API访问：

从以下位置获取代币：https://online.seranking.com/admin.api.dashboard.html

根据您需要的工具，您可以使用一个或两个令牌。如果只使用Data API工具，则可以省略 PROJECT_API_TOKEN反之亦然。

速率限制

费率限制是可定制的。联系 api@seranking.com 请求调整。

安装

选择最适合您需求的安装方法：

• 选项1:Docker（推荐） -最适合标准使用、稳定性和易于更新。如果您只想运行该工具而不管理依赖关系，请使用此选项。
• 选项2：本地Node.js服务器（适用于开发人员） -最适合开发、调试或Docker不可用的环境（如Replit）。如果需要修改代码或运行自定义安装程序，请使用此选项。

选项1:Docker（推荐）

1. 打开您的终端（或Windows上的命令提示符/PowerShell）。
2. 从GitHub克隆项目存储库：

git clone https://github.com/seranking/seo-data-api-mcp-server.git

1. 导航到新目录：

cd seo-data-api-mcp-server

1. 构建Docker镜像：

docker build -t se-ranking/seo-data-api-mcp-server .
# Check that the image is built and named `se-ranking/seo-data-api-mcp-server`:
docker image ls

如何更新SEO-MCP（Docker）

为确保您拥有最新功能，请提取最新更改并重新生成：

git pull origin main
docker build -t se-ranking/seo-data-api-mcp-server .

选项2：本地Node.js服务器（适用于开发人员）

为了运行本地Node服务器，您需要 您计算机上安装的版本。

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

1. 启动服务器：

npm run start-http

那么你的HTTP服务器应该在以下位置运行：http://0.0.0.0:5000/mcp.

如果您想修改 HOST 和 PORT，您可以通过创建 .env 项目根目录中的文件，其中包含要覆盖的设置，例如：

HOST=127.0.0.1
PORT=5555

此外，在外部环境中运行时，例如 Replit，您可以设置 DATA_API_TOKEN 和 PROJECT_API_TOKEN 配置面板中的环境变量。

备注：如果在服务器运行时更改API令牌值，则需要重新启动服务器。

验证HTTP服务器

要发送示例测试请求并验证您的设置，请执行以下操作：

./test-http-server-curl-request.sh ''

对于批量MCP请求测试：

./test-batch-http-server-curl-request.sh ''

连接到克劳德桌面

Claude Desktop从以下位置读取其配置 claude_desktop_config.json.

• 点击克劳德菜单并选择 设置。...
• 在“设置”窗口中，导航到 开发者 左侧边栏中的选项卡。
• 点击 编辑配置 按钮打开配置文件。如果配置文件不存在，此操作将创建一个新的配置文件，或打开现有的配置。

该文件位于：

• macOS： ~/Library/Application\ Support/Claude/claude_desktop_config.json
• 窗户： %AppData%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

例子 克劳德桌面版 MCP服务器的配置

JSON配置模板:

{
  "mcpServers": {
    "seo-data-api-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATA_API_TOKEN",
        "-e",
        "PROJECT_API_TOKEN",
        "se-ranking/seo-data-api-mcp-server"
      ],
      "env": {
        "DATA_API_TOKEN": "",
        "PROJECT_API_TOKEN": ""
      }
    }
  }
}

• 更换 DATA_API_TOKEN 和 PROJECT_API_TOKEN 带有标记的占位符值（请参见 API令牌 部分）。

• 保存后 claude_desktop_config json，重新启动克劳德桌面。您应该在MCP服务器/工具下看到服务器。

• 要验证设置，请询问Claude： Do you have access to MCP? 它应该通过列出来回应 seo-data-api-mcp.

Claude Desktop: Verify the MCP access

• 您的设置已完成！现在，您可以使用自然语言运行复杂的SEO查询。

Claude Desktop: List MCP Servers

连接到Gemini CLI

• 打开Gemini CLI设置文件，该文件通常位于： ~/.gemini/settings.json
• 添加以下JSON配置，确保 替换API令牌占位符值。

{
  "mcpServers": {
    "seo-data-api-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATA_API_TOKEN",
        "-e",
        "PROJECT_API_TOKEN",
        "se-ranking/seo-data-api-mcp-server"
      ],
      "env": {
        "DATA_API_TOKEN": "",
        "PROJECT_API_TOKEN": ""
      }
    }
  }
}

更换 DATA_API_TOKEN 和 PROJECT_API_TOKEN 带有标记的占位符值（请参见 API令牌 部分）。

• 保存配置文件。

• 要验证设置，请启动 Gemini CLI 通过跑步 gemini 在你的终端。界面激活后，按 Ctrl+T 查看可用的MCP服务器。确保列出了seo数据api mcp。

Gemini CLI: Configured MCP Servers

• 您的设置已完成！现在，您可以使用自然语言运行复杂的SEO查询。

Gemini CLI: SEO Queries Example

可用工具

API数据工具

API项目工具

可用提示

用法示例：查找关键字机会

配置完成后，您现在可以使用自然语言提示与SE排名数据进行交互。下面是一个示例提示，用于识别域的低挂关键字机会。

将以下内容复制并粘贴到您配置的AI助手中：

Use the seo-mcp to identify the Keywords my domain is overlooking and find low-hanging fruit opportunities.
1. Analyze my domain's keyword performance:
   - Find keywords my domain has lost (not ranking) using the tool for getDomainKeywords with pos_change=lost.
   - Find keywords where my domain's position has gone down using the tool for getDomainKeywords with pos_change=down.
2. Conduct a competitive analysis:
   - Identify my top 2 competitors by finding all competitors with the tool for getDomainCompetitors and ordering them by common_keywords DESC.
   - Find 30 keywords that these competitors are ranking for but my domain is not. Use the getDomainKeywordsComparison tool with diff=1, order_field=volume, and order_type=DESC.
3. Identify new keyword opportunities:
   - For 10 of the competitor keywords found in the previous step, use the tools for getRelatedKeywords and getSimilarKeywords to find the top 5 related and similar keywords for each, ordered by volume DESC.
4. Synthesize and Report:
   - Create a final report of the findings. In the report, highlight potential low-hanging fruit from the new keyword opportunities by analyzing their CPC and keyword difficulty.
Domain to review: seranking.com
Market: us

此提示的作用

该提示指示模型通过以下方式进行全面的竞争分析：

• 查找丢失和拒绝的关键字：它首先确定seranking.com的关键字，这些关键字要么从排名中丢失，要么排名下降。
• 识别顶级竞争对手：它会找到所有有机竞争对手，并根据共享关键字的数量对其进行排序，以确定前两名。
• 揭示竞争对手排名关键词：它将seranking.com与其顶级竞争对手进行比较，找到他们排名的30个高容量关键字，但seranking.com没有。
• 生成最终报告：最后，它将所有这些信息综合成一份简明的报告，突出了最有希望的增长机会。

故障排除

Docker镜像问题

如果您在连接MCP服务器时遇到问题，以下是诊断问题的几个步骤。

当您运行AI助手（Claude或Gemini）时，验证Docker容器是否正在运行。如果你开始与AI聊天，并且你的MCP服务器通过JSON配置正确设置，它应该会自动启动Docker容器。

要检查它是否正在运行，请打开终端并运行：

docker ps

如果它工作正常，您将看到类似于以下内容的输出：

CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS     NAMES
de4e410ef0fd   se-ranking/seo-data-api-mcp-server       "docker-entrypoint.s…"   9 seconds ago    Up 8 seconds              musing_bhabha

这证实了你的AI助手已成功启动容器，并且正在监听连接。

如果 docker ps 显示没有与MCP服务器相关的正在运行的容器，这通常指向配置问题：

• JSON不正确/无效：请仔细检查 claude_desktop_config json 或 settings.json 对于任何语法错误，如缺少逗号或括号。您可以在此处验证JSON：https://jsonlint.com/.

• 图像名称不正确：请仔细检查 claude_desktop_config json 或 settings.json 正确的图像名称 se-ranking/seo-data-api-mcp-server

Docker镜像正在运行，但MCP服务器在Claude Desktop/Gemini CLI中不可见

如果docker镜像正在运行，但MCP服务器在Claude Desktop中不可见，您可以通过以下方式调查容器：

docker inspect 

对于以下示例，容器ID为 de4e410ef0fd:

CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS     NAMES
de4e410ef0fd   se-ranking/seo-data-api-mcp-server       "docker-entrypoint.s…"   9 seconds ago    Up 8 seconds              musing_bhabha

注意：如果没有其他容器共享该前缀，您可以缩短容器ID，例如。 docker inspect de4。当您运行多个连接到MCP服务器的AI聊天和/或工具时，可以运行多个容器，但所有容器都具有相同的IMAGE名称。

这将向您显示巨大的JSON输出，其中特别重要的是“Config”部分，例如：

{
  "Config": {
    "Hostname": "0977c3dc06fb",
    "Domainname": "",
    "User": "",
    "AttachStdin": true,
    "AttachStdout": true,
    "AttachStderr": true,
    "Tty": false,
    "OpenStdin": true,
    "StdinOnce": true,
    "Env": [
      "DATA_API_TOKEN=80cfee7d-xxxx-xxxx-xxxx-fc8500816bb3",
      "PROJECT_API_TOKEN=253a73adxxxxxxxxxxxxxx340aa0a939",
      "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
      "NODE_VERSION=20.19.5",
      "YARN_VERSION=1.22.22",
      "NODE_ENV=production"
    ]
  }
}

这将显示您是否设置了正确的环境变量。

贡献

先决条件

• Node.js 20+
• npm

运行测试

# Run all tests (compiles TypeScript first)
npm test

# Run only E2E tests
npm run test:e2e

# Run tests in watch mode
npm run test:watch

测试环境变量

创建一个 .env 项目根目录中的文件，包含以下变量：

E2E测试

E2E测试 真正的API调用 SE排名服务。它们在默认情况下被禁用，以避免在开发过程中使用不必要的API。

• 当 E2E_ENABLED=false 如果未设置，则跳过E2E测试
• 集 E2E_ENABLED=true 使用实时API调用运行完整的测试套件
• 在启用E2E测试之前，请确保您拥有有效的API令牌

其他开发命令

# Lint code
npm run lint
npm run lint:fix

# Format code
npm run format
npm run format:check

# Type check
npm run typecheck

支持

SE排名API文档：https://seranking.com/api/integrations/mcp/.

如果您有任何问题或需要帮助，请通过以下方式联系我们： api@seranking.com