关于 Serpapi
Serpapi 是将 SerpApi 搜索接口封装为 MCP 工具的服务,面向需要学术、地图、趋势、职位、新闻和购物搜索的用户。调用时需提供自己的 SerpApi API 密钥,可通过 Pipeworx 网关或本地 stdio 使用。
主要功能
- 01Google Scholar 论文搜索
- 02Google Maps 商家搜索
- 03Google Trends 趋势查询
- 04Google Jobs 职位搜索
- 05Google News 与 Shopping 搜索
适用场景
- 01查找学术论文及引用信息
- 02搜索本地商家与联系方式
- 03查看关键词趋势和地区热度
- 04查找职位、新闻或商品
MCP 相关
向 MCP 客户端提供 SerpApi 的学术、地图、趋势、职位、新闻和购物搜索工具。工具调用需传入自己的 SerpApi API 密钥;服务可经 Pipeworx 网关连接,也可本地通过 stdio 运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/serpapi/mcpclaude mcp add --transport http pipeworx-io-serpapi https://gateway.pipeworx.io/serpapi/mcp{"mcpServers":{"pipeworx-io-serpapi":{"type":"http","url":"https://gateway.pipeworx.io/serpapi/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-serpapi":{"type":"http","url":"https://gateway.pipeworx.io/serpapi/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-serpapi":{"type":"http","url":"https://gateway.pipeworx.io/serpapi/mcp"}}}{"mcpServers":{"pipeworx-io-serpapi":{"serverUrl":"https://gateway.pipeworx.io/serpapi/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
mcp-serpapi
SerpApi MCP — 封装 SerpApi(serpapi.com)搜索引擎
属于 Pipeworx — 一个连接 AI Agent 与 1683+ 个实时数据源的 MCP 网关。
工具
| 工具 | 描述 |
|---|---|
serpapi_google_scholar | 通过 SerpApi 在 Google Scholar 上搜索有关 <topic> 的学术论文 — 返回标题、链接、摘要、出版信息和引用次数。示例:serpapi_google_scholar({ q: "graph neural networks", as_ylo: 2020, num: 10, _apiKey: "your-serpapi-key" }) |
serpapi_google_maps | 通过 SerpApi 在 Google Maps 上查找 <query> 对应的本地商家 — 返回名称、地址、评分、评论、电话、网站和 GPS 坐标。示例:serpapi_google_maps({ q: "coffee shops", ll: "@40.7,-74.0,14z", _apiKey: "your-serpapi-key" }) |
serpapi_google_trends | 通过 SerpApi 获取 <terms> 的 Google Trends 随时间变化的热度 — 返回所请求的趋势数据块(随时间变化的热度、按地区划分的热度或相关查询)。示例:serpapi_google_trends({ q: "bitcoin,ethereum", date: "today 12-m", geo: "US", _apiKey: "your-serpapi-key" }) |
serpapi_google_jobs | 通过 SerpApi 在 Google Jobs 上搜索 <query> — 返回职位名称、公司、地点、来源、发布日期、工作安排、描述和申请链接。示例:serpapi_google_jobs({ q: "data engineer", location: "Austin, TX", _apiKey: "your-serpapi-key" }) |
serpapi_google_news | 通过 SerpApi 在 Google News 上搜索 <query> — 返回标题、来源、链接、日期和摘要。示例:serpapi_google_news({ q: "openai", gl: "us", hl: "en", _apiKey: "your-serpapi-key" }) |
serpapi_google_shopping | 通过 SerpApi 在 Google Shopping 上搜索 <query> — 返回商品标题、价格、来源、评分、评论、商品 ID 和链接。示例:serpapi_google_shopping({ q: "wireless earbuds", gl: "us", hl: "en", _apiKey: "your-serpapi-key" }) |
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"serpapi": {
"url": "https://gateway.pipeworx.io/serpapi/mcp"
}
}
}
此端点实际提供的内容
tools/list 在 https://gateway.pipeworx.io/serpapi/mcp 返回上表中的工具,以及 Pipeworx 的共享元工具 — ask_pipeworx、
discover_tools、search_within、remember/recall,以及网关范围内的其他工具。因此,你看到的工具数量会多于此表中的数量:单个工具包端点当前会列出大约 30 个共享工具,以及该工具包自身的工具。连接的 initialize 响应会说明其确切范围,并且是当天适用范围的权威依据。
这是有意为之,并非意外进行了多路复用。元工具让范围受限的连接能够通过 ask_pipeworx 路由到整个目录,从而回答此工具包无法涵盖的问题 — 无需你再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点;如果额外的架构定义消耗的上下文超过路由带来的价值,请只连接一次完整网关,而不是连接多个工具包端点。
你也可以连接完整的 Pipeworx 网关,直接列出所有工具包的工具,而不只是当前工具包的工具:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
两个 URL 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出哪个工具包的工具;通过任一端点,ask_pipeworx 都能访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
此工具包需要你提供自己的 API 密钥(_apiKey)— 我们不会代为提供,因此没有不带密钥即可运行的 curl 命令。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/serpapi_google_scholar。查找工具:使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。
独立运行(无需 gateway 账号)
此软件包也可作为本地 stdio MCP 服务运行,无需 Pipeworx 账号,也无需经过网关往返:
{
"mcpServers": {
"serpapi": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-serpapi"]
}
}
}
或者直接运行,确认它可以启动:
npx -y @pipeworx/mcp-serpapi
它通过 stdin/stdout 使用 MCP 通信,并响应 initialize/tools/list/tools/call,仅提供此软件包中的工具,不包含上方网关连接额外提供的任何共享元工具。使用相同的源代码和工具,无需 ask_pipeworx 路由。
使用 ask_pipeworx
你可以用通俗的英语提问,而不是直接调用工具——这既适用于上方的软件包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Serpapi data" })
网关会选择合适的工具并自动填入参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。