SerpCheap
打开控制台

MCP FOR AI AGENTS

让 AI 连接搜索，
让答案有据可查。

将 Google 网页搜索接入 AI 客户端，获取带来源网址的搜索结果。

  1. 01

    创建 API Key

    在控制台创建密钥，使用现有积分。

  2. 02

    添加客户端配置

    复制配置，填入你的 API Key。

  3. 03

    开始搜索

    启用 google_search，获取网页与来源链接。

创建 API Key查看 MCP 文档

连接你的 AI 客户端

Streamable HTTP
MCP ENDPOINT
https://serpcheap.com/mcp

Cursor · mcp.json

{
  "mcpServers": {
    "serpcheap": {
      "headers": {
        "Authorization": "Bearer ${env:SERP_API_KEY}"
      },
      "url": "https://serpcheap.com/mcp"
    }
  }
}

Claude Code · Terminal

claude mcp add --transport http serpcheap https://serpcheap.com/mcp --header "Authorization: Bearer ${SERP_API_KEY}"

VS Code · mcp.json

{
  "inputs": [
    {
      "description": "SERP API Key",
      "id": "serp-key",
      "password": true,
      "type": "promptString"
    }
  ],
  "servers": {
    "serpcheap": {
      "headers": {
        "Authorization": "Bearer ${input:serp-key}"
      },
      "type": "http",
      "url": "https://serpcheap.com/mcp"
    }
  }
}

Codex · Terminal

codex mcp add serpcheap --url https://serpcheap.com/mcp --bearer-token-env-var SERP_API_KEY

按所选客户端配置密钥；使用环境变量的客户端请先设置 SERP_API_KEY，勿将密钥公开。

共用 API Key 与积分
成功搜索 1 积分
失败与工具发现不扣费

兼容支持自定义鉴权请求头的 Streamable HTTP 客户端，暂不支持仅 OAuth 的客户端。

MCP 接口文档了解积分计费

ONE TOOL. STRUCTURED SEARCH.

一个工具，接通网页搜索。

通过 MCP，兼容的 AI 客户端可以发现并调用 google_search。客户端发出查询，SerpCheap 返回结构化搜索数据，再由模型整理回答与来源。

google_search

Google 网页 · 第一页
q必填
搜索关键词，最多 2,000 个 UTF-8 字节。
gl默认 us
搜索国家，例如 us、de。
hl默认 en
搜索语言，例如 en、de。
查看 MCP 接口说明

静态示例 · 工具参数，并非完整 MCP 协议请求

google_search · JSON
{
  "q": "Go programming documentation",
  "gl": "us",
  "hl": "en"
}

客户端会拿到什么

  • result.organic · 标题、链接、摘要与原始排名。
  • result.searchParameters · q / gl / hl
  • requestId / httpStatus · 请求追踪与处理状态。
  • result.credits · 每次成功请求扣 1 积分。

相关问题、相关搜索、知识图谱等模块按实际数据返回，不承诺固定结果条数。

SEARCH INSIDE YOUR WORKFLOW

从一个问题，进入你的工作流。

了解应用场景

将提示词复制到已配置的客户端。页面不会执行示例，实际成功搜索会消耗自己的积分。

带来源的主题调研

找到相关网页，再由模型比较、整理与归纳。

使用 google_search 搜索 RAG 的实际应用，设置 gl=us、hl=en，并在总结中列出来源链接。

查找开发者文档

为开发任务查找官方指南和相关示例。

使用 google_search 查找 Go context 的官方文档，设置 gl=us、hl=en，列出相关页面及来源链接。

比较地域搜索结果

分别指定国家和语言，比较不同搜索设置的结果。

使用 google_search 搜索电动自行车，分别设置 gl=us、hl=en 和 gl=de、hl=de，对比返回来源；每次成功搜索扣 1 积分。

01

AI 客户端

理解问题，决定何时调用搜索工具。

02

SerpCheap 搜索

校验 Key，按 q、gl、hl 执行搜索。

03

带来源的回答

将搜索数据交还模型，由客户端整理与核对回答。

ONE ACCOUNT. ONE BALANCE.

同一个账号，同一份积分。

无需单独订阅 MCP。REST、MCP 和 Playground 使用同一套 API Key、余额和请求记录。

成功搜索，含有效空结果
1 积分
工具发现与最终搜索失败
0 积分
购买的积分
永不过期
查看价格与积分规则

CONNECTION HELP

接入遇到问题？从这里排查。

反馈搜索失败时请保留请求编号。文档提供鉴权、错误状态与请求追踪的说明。

查看错误说明
为什么看不到 google_search 工具？

检查 /mcp 地址、客户端配置和 Authorization: Bearer 请求头。替换示例密钥，启用或重新连接服务，再刷新客户端的工具列表。

只支持 OAuth 的客户端可以接入吗？

暂不支持。当前使用 API Key 鉴权，需要客户端支持 Streamable HTTP 和自定义请求头；也可在应用中通过 REST 接入。

连接成功，为什么搜索仍然失败？

发现工具不代表余额和搜索可用性已通过检查。请查看工具结果的 isError 与 httpStatus，核对 Key、剩余积分及限流情况；连接成功并不等于搜索成功。

模型多次调用工具，会重复扣费吗？

每次成功搜索扣 1 积分，包括重复查询。一个任务可能发起多次搜索，可通过请求日志和积分流水核对用量。

超时或触发 429 后应该怎么办？

超时且结果不明确时，请先核对请求日志和积分流水，再决定是否重新提交。新的成功请求会计费。触发限流时，遵循 Retry-After（如有）并降低并发，避免无限自动重试。

搜索失败也会消耗积分吗？

最终失败不扣费，预留积分会释放。每次成功请求扣 1 积分，明确的无搜索结果也属于成功。

让你的 AI 客户端，拥有搜索能力。

创建 Key，复制上方配置，用自己的积分开始一次搜索。

创建 API KeyMCP 接口文档