Serper.live

Serper.live MCP 服务

为 AI Agent 提供实时 Google 搜索。这个 Model Context Protocol 服务允许 Claude、OpenAI Codex、Cursor、VS Code 和其他 MCP 客户端通过 Serper.live 执行真正的 Google 搜索，查询你选择的国家、语言和设备，并检查某个域名当前的排名。

每次搜索都是全新的：不会缓存任何内容，通常 2–3 秒即可返回 10 条结果。排名只计算自然搜索结果，不包括广告、站点链接、视频或图片模块，因此 Agent 读取的数字就是排名跟踪工具会记录的数字。

工具

工具	功能	费用
google_search	获取关键词的实时自然搜索结果：position、title、url、domain、snippet，每次调用最多 100 条	按每页最多 10 条结果计费
domain_position	查询某个域名在特定国家和设备上的关键词排名；如果出现多次，则返回每个排名；否则返回“未进入前 N 名”	按检查的深度计费，费用与 google_search 相同
list_countries	当前开放的市场及各自默认的 Google 语言	免费，无需令牌

参数：query（2–120 个字符）、country（两个字母的代码，例如 US、GB、DE、FR、TR、UA）、可选的 language（Google 界面语言，默认为该国家的语言）、device（desktop 或 mobile），以及 limit / depth（1–100，默认为 10）。

设置

1. 在 serper.live 创建账户并充值（使用 USDT 或 USDC，最低 5 美元；无需订阅，余额永不过期），然后在 API tokens 创建 API 令牌。
2. 使用 SERPER_LIVE_TOKEN 中的令牌将服务添加到客户端。服务通过 npx 运行，因此只需 Node.js 20 或更高版本；Claude Desktop 也可以一键安装，无需 Node.js。

Claude Code

claude mcp add serper-live -e SERPER_LIVE_TOKEN=sl_live_YOUR_TOKEN -- npx -y @serper-live/mcp

Claude Desktop

一键安装：从最新版本下载 serper-live-mcp.mcpb 并打开。Claude Desktop 会显示安装对话框，只需输入一次 API 令牌，并安全地保存令牌，然后使用自带的 Node.js 运行服务。

也可以手动在 claude_desktop_config.json 中配置：

{
  "mcpServers": {
    "serper-live": {
      "command": "npx",
      "args": ["-y", "@serper-live/mcp"],
      "env": {
        "SERPER_LIVE_TOKEN": "sl_live_YOUR_TOKEN"
      }
    }
  }
}

Cursor

在项目中的 ~/.cursor/mcp.json 或 .cursor/mcp.json 中配置：

{
  "mcpServers": {
    "serper-live": {
      "command": "npx",
      "args": ["-y", "@serper-live/mcp"],
      "env": {
        "SERPER_LIVE_TOKEN": "sl_live_YOUR_TOKEN"
      }
    }
  }
}

VS Code

.vscode/mcp.json — VS Code 会要求输入一次令牌，并将其保存在文件之外：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "serper-live-token",
      "description": "Serper.live API token",
      "password": true
    }
  ],
  "servers": {
    "serper-live": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@serper-live/mcp"],
      "env": {
        "SERPER_LIVE_TOKEN": "${input:serper-live-token}"
      }
    }
  }
}

OpenAI Codex

codex mcp add serper-live --env SERPER_LIVE_TOKEN=sl_live_YOUR_TOKEN -- npx -y @serper-live/mcp

也可以手动在 ~/.codex/config.toml 中配置（Codex CLI、其 IDE 扩展和 ChatGPT 桌面应用共用此文件）：

[mcp_servers.serper-live]
command = "npx"
args = ["-y", "@serper-live/mcp"]

[mcp_servers.serper-live.env]
SERPER_LIVE_TOKEN = "sl_live_YOUR_TOKEN"

对于任何其他 MCP 客户端：在标准输入输出上运行 npx -y @serper-live/mcp，并在环境中设置 SERPER_LIVE_TOKEN。通过代码库配置服务的 Agent（例如 Cline），请参阅 llms-install.md。

环境变量

变量	是否必需	说明
SERPER_LIVE_TOKEN	搜索时必需	来自 API tokens 的 API 令牌。没有此令牌，list_countries 仍可使用
SERPER_LIVE_API_URL	否	API 基础 URL，默认为 https://api.serper.live

可以询问什么

• “在德国的移动设备上，Google 搜索 project management software 时，example.com 排名第几？检查前 30 名。”
• “比较美国和英国 Google 搜索 best running shoes 的前 10 条结果。”
• “可以搜索哪些市场？”

计费和重试

搜索按每页最多 10 条自然搜索结果计费，从 Serper.live 余额中扣除，价格取决于市场（定价）；桌面和移动设备的费用相同。每次调用都会发送一个 Idempotency-Key，因此重复调用绝不会重复计费。

开发

npm install
npm run build
npx @modelcontextprotocol/inspector node dist/index.js
npm run bundle   # serper-live-mcp.mcpb: dist/, manifest.json, icon.png and the production dependencies

发布

版本号位于 package.json 的 version 字段、server.json 的 packages[0].version 字段（MCP Registry 会将其与 npm 中的版本进行核对），以及 MCP Bundle 的 manifest.json 中。npm version 会设置所有这些版本号：其 version 脚本（scripts/sync-version.mjs）会将新版本号复制到 server.json 和 manifest.json 中。

推送 v* 标签后会运行 .github/workflows/publish.yml：它会检查标签是否与所有版本字段匹配，构建、打包并验证 MCP Bundle，通过可信发布发布到 npm（无需 npm 令牌，并附带来源证明），等待 npm 提供新版本（最长 30 分钟），将 serper-live-mcp.mcpb 附加到 GitHub release，并通过 GitHub OIDC 更新 MCP Registry，其中包含两个包：npm 包和带有其 SHA-256 的 bundle。运行失败后可以直接重新运行：npm 上已有的版本不会再次发布，release 资源会被替换。

npm version x.y.z --no-git-tag-version   # package.json, package-lock.json, server.json, manifest.json
git commit -am "Release x.y.z"
git tag vx.y.z
git push && git push origin vx.y.z

npm 包将此工作流列为可信发布者（在包设置 → Trusted Publisher → GitHub Actions 中设置：serper-live/serper-live-mcp，工作流 publish.yml，并在 Allowed actions 下勾选 Allow npm publish）。

链接

• Serper.live — Google 实时 SERP API
• API 文档
• Playground — 无需账户，即可在浏览器中尝试实时搜索
• 联系

许可证

MIT