Live Rank Tracker MCP

实时SERP排名跟踪器MCP服务器

FastMCP 2.0服务器，用于使用Serper.dev API跟踪实时搜索引擎排名。跟踪关键字排名，监控特定域名的位置，并通过基于位置的定位获得全面的搜索见解。

特性

• 查看域名排名：查找特定关键字的域名位置
• 顶级排名：获取任何关键字的顶部搜索结果
• 多关键字跟踪：同时跟踪一个域的多个关键字
• 基于位置的搜索：支持国家和城市一级的目标定位
• 搜索洞察：获取相关搜索、“人们也会问”和知识图数据

可用工具

1. check_ranking

检查关键字的特定域的排名位置。

参数：

• keyword （必填）：搜索关键字
• domain （必填）：要查找的域名（例如“apple.com”）
• location （可选）：城市/地区（例如，“澳大利亚维多利亚州墨尔本”）
• country （可选）：国家代码（例如“au”）

2. get_top_rankings

获取关键字的最高排名结果。

参数：

• keyword （必填）：搜索关键字
• location （可选）：城市/地区
• country （可选）：国家代码
• limit （可选）：结果数量（默认值：10，最大值：100）

3. track_multiple_keywords

跟踪特定域的多个关键字的排名。

参数：

• keywords （必填）：要跟踪的关键字列表
• domain （必填）：要跟踪的域
• location （可选）：城市/地区
• country （可选）：国家代码

4. get_search_insights

获得全面的搜索见解，包括相关搜索和人们也会问。

参数：

• keyword （必填）：搜索关键字
• location （可选）：城市/地区
• country （可选）：国家代码

设置

1.安装依赖项

# Create virtual environment (if not already created)
python -m venv .venv

# Activate virtual environment
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

2.配置API密钥

1. 从获取API密钥 Serper.dev
2. 复制 .env.example 到 .env:

   cp .env.example .env

1. 编辑 .env 并添加您的API密钥：

   SERPER_API_KEY=your_actual_api_key_here

3.测试API连接（可选）

在运行完整服务器之前，您可以测试Serper API连接：

python test_server.py

这将验证您的API关键工作，并显示示例结果。

4.运行服务器

# Make sure your virtual environment is activated
python server.py

或者使用FastMCP的开发模式：

fastmcp dev server.py

5.配置Claude Desktop（可选）

要将此服务器与Claude Desktop一起使用，请将以下内容添加到您的Claude Desktop配置文件中：

窗户： %APPDATA%\Claude\claude_desktop_config.json MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "live-rank-tracker": {
      "command": "python",
      "args": ["C:\\Users\\hp\\code\\mcp\\live-rank-tracker\\server.py"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

将路径和API键替换为实际值。

用法示例

示例1：检查域名排名

check_ranking(
    keyword="apple inc",
    domain="apple.com",
    location="Melbourne, Victoria, Australia",
    country="au"
)

示例2：获得前10名排名

get_top_rankings(
    keyword="python programming",
    location="New York, NY, USA",
    country="us",
    limit=10
)

示例3：跟踪多个关键字

track_multiple_keywords(
    keywords=["apple inc", "apple stock", "apple news"],
    domain="apple.com",
    location="San Francisco, CA, USA",
    country="us"
)

示例4：获取搜索洞察

get_search_insights(
    keyword="machine learning",
    location="London, England, UK",
    country="uk"
)

国家代码

通用国家代码 country 参数：

• us -美国
• uk -联合王国
• au -澳大利亚
• ca -加拿大
• de -德国
• fr -法国
• jp -日本
• in -印度

位置格式

位置的格式应为： "City, State/Province, Country"

示例：

• "New York, NY, USA"
• "London, England, UK"
• "Melbourne, Victoria, Australia"
• "Toronto, Ontario, Canada"

响应格式

所有工具都会返回带有相关排名数据的JSON响应：

{
  "keyword": "apple inc",
  "domain": "apple.com",
  "position": 1,
  "url": "https://www.apple.com",
  "title": "Apple",
  "snippet": "Discover the innovative world of Apple...",
  "location": "Melbourne, Victoria, Australia",
  "country": "au",
  "found": true
}

错误处理

服务器包括全面的错误处理：

• API密钥验证
• 请求超时处理（30秒）
• JSON格式的详细错误消息

备注

• Serper API有基于您的订阅计划的费率限制
• 结果实时从谷歌获取
• 位置计数从1开始（第一个有机结果）
• 服务器仅搜索自然结果（不包括广告）

许可证

麻省理工学院