Agent 需要最新 Google 数据时,如果只丢给它一条 curl 指令,Agent 得自己猜 API 细节。Model Context Protocol(MCP)解决这个问题:搜索变成一个 Agent 用结构化参数调用的工具。

SerpBase 有一个 MCP server,把六个端点全部暴露成 Agent 工具。下面是接入方法。

安装和配置

pip install serpbase-mcp
export SERPBASE_API_KEY=你的key

把支持 MCP 的客户端指过来:

{
  "mcpServers": {
    "serpbase": {
      "command": "python",
      "args": ["-m", "serpbase_mcp"],
      "env": { "SERPBASE_API_KEY": "你的key" }
    }
  }
}

Claude Desktop、Cursor、Codex 都能读取这个配置,工具会出现在 Agent 的工具列表里。

Agent 看到什么

每个端点是一个带 inputSchema 的工具。/google/search 收 query(必填)加可选 hl/gl/page/device。结果是结构化的——organic 每条带 rank/title/link/snippet,Agent 可以引用排名和链接,而不是从一段文字里猜。

一个 grounded 流程

1. Agent 收到需要实时数据的问题。
2. 它用 query 调用 google_search。
3. 工具返回 organic 结果。
4. Agent 总结并引用链接。
5. 可选验证:检查每条声明都能对应到某条 snippet。

积分,老实说

每次成功的工具调用都消耗积分:search/news/videos 各 1 积分,images 和两个 Maps 端点各 2 积分。Agent 换个措辞反复查同一个 query,成本会累积。两个对策:

• 告诉 Agent 复用结果,而不是重新搜索同一个意图。
• 会话内对相同 query 缓存工具结果。

什么时候别用 MCP

MCP 适合交互式桌面/IDE Agent。如果是服务端管线、只需要结果,直接调 HTTP API 更简单——没有传输层,没有客户端依赖。

要点

MCP server 把 SERP 数据变成一等公民的 Agent 工具:结构化输入、结构化输出、一次配置。SerpBase 自带一个,你不用手搓胶水。完整细节:serpbase.dev/docs。