MCP 接入

通过 SerpHubAPI 为 Claude Code、Cursor、Claude Desktop 或任意 MCP 客户端加上网页搜索与正文抓取能力。

官方 MCP Server serphubapi-mcp 把 SerpHubAPI 封装成四个工具，agent 可以直接调用。它通过 stdio 在本地运行，用你的 API Key 访问 https://api.serphubapi.com。

工具

工具	功能	积分
`list_services`	服务目录：可搜索的每组 `engine`/`type`，含价格和实时状态。	0
`search`	目录里的任意服务——搜索引擎、App 内搜索、AI 搜索——以 Markdown 返回。`include_content=N` 会同时返回前 N 个网页的全文。	该服务单价（如 `google/web` 10；cache_first 半价，命中缓存为 0）+ 每页正文 3
`fetch`	任意公开 URL → Markdown 格式的正文。	3（失败为 0）
`batch`	一次调用跑最多 5 条搜索，每条以 Markdown 返回；一条失败不阻塞其余条。	每条按 `search` 计费（失败/空结果/缓存命中免费）

调用失败和空结果一律不计费。

准备

在 /dashboard/keys 获取 SerpHubAPI API Key。新账户赠送 1,000 积分。
安装 uv（自带 uvx）。首次使用时会自动下载并运行 MCP Server。

Claude Code

claude mcp add serphubapi -e SERPHUBAPI_API_KEY=shapi_xxxxxxxx -- uvx serphubapi-mcp

Cursor

写入 ~/.cursor/mcp.json（或项目内的 .cursor/mcp.json）：

{
  "mcpServers": {
    "serphubapi": {
      "command": "uvx",
      "args": ["serphubapi-mcp"],
      "env": { "SERPHUBAPI_API_KEY": "shapi_xxxxxxxx" }
    }
  }
}

Claude Desktop

打开 Settings → Developer → Edit Config，编辑 claude_desktop_config.json，加入同样的配置后重启 Claude Desktop：

{
  "mcpServers": {
    "serphubapi": {
      "command": "uvx",
      "args": ["serphubapi-mcp"],
      "env": { "SERPHUBAPI_API_KEY": "shapi_xxxxxxxx" }
    }
  }
}

其他 MCP 客户端

只要客户端能启动 stdio 类型的 MCP Server 即可：命令 uvx，参数 serphubapi-mcp，再配上下面的环境变量。

环境变量

变量	默认值	说明
`SERPHUBAPI_API_KEY`	—	必填，你的 API Key。
`SERPHUBAPI_BASE_URL`	`https://api.serphubapi.com`	仅在客服指引下修改。

使用建议

为每个 agent 或每台机器单独建一个 Key，并在 /dashboard/keys 设置每日积分上限，避免 agent 陷入循环把余额耗光。
每次工具调用都会出现在 /dashboard/logs，可看到搜索词和扣费。
如果工具没有出现，先在终端运行 uvx serphubapi-mcp 确认能正常启动，再检查客户端配置里是否填了 Key。