serpapi-mcp

🔍 企业级实时搜索与智能归档

基于 SerpAPI MCP 的高安全性搜索工具,支持多 Key 自动轮替与可选 Airtable 归档,通过 A 级安全审计。

收藏
6.5k
安装
2.3k
版本
v1.1.1
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

serpapi-mcp 是一个基于 Model Context Protocol (MCP) 的高安全性搜索集成工具,专为需要在 AI 工作流中嵌入实时网络搜索能力的用户设计。该技能通过封装 SerpAPI 的官方 MCP 服务器,为用户提供了一个简洁但功能强大的 /serp 命令接口,能够在保持代码库整洁的同时,实现企业级的搜索数据采集与归档能力。

在核心用法方面,用户只需通过简单的命令语法 /serp <query> [engine] [num] [mode] 即可触发搜索。默认配置采用 google_light 引擎返回 5 条紧凑结果,但可通过切换至 google 引擎和 complete 模式获取包括 PAA(People Also Ask)、知识图谱、视频包等丰富的 SERP 特性。技能底层通过 mcporter CLI 与 SerpAPI 的 MCP 端点通信,确保所有交互符合 MCP 协议规范,返回的标准 JSON 数据可直接用于下游分析或展示。

该技能的显著优点体现在其健壮性与灵活性上。首先,代码通过了严格的 A 级安全审计,采用 set -euo pipefail 安全模式,无任何危险函数或注入漏洞,临时文件处理规范。其次,内置的 API Key 轮替机制支持配置多个 SerpAPI 密钥,在遭遇配额或限流错误时自动故障转移,极大提升了生产环境的稳定性。此外,可选的 Airtable 集成功能允许用户将搜索历史、原始 JSON 及结构化摘要自动归档,且该功能需显式启用并配置完整凭据后才激活,充分尊重用户的数据主权。

然而,用户也需注意其潜在局限性。作为 T3 来源(个人开发者账号)的项目,虽然代码质量达到 A 级标准,但长期维护的稳定性仍需观察。功能上依赖外部 SerpAPI 服务及 mcporter CLI 工具,在无网络环境或未安装依赖的场景下无法使用。Airtable 归档功能虽强大,但需要用户预先配置复杂的表结构(包括 20 余个字段),且受 Airtable 单单元格 90KB 字符限制,超大数据集可能面临截断。

该技能特别适合需要将实时搜索能力集成到自动化工作流中的开发者、研究人员和数据分析师,以及有搜索历史审计需求的企业团队。对于追求代码安全性的用户,该技能的透明数据流(查询仅发送至 SerpAPI,无中间服务器)和可选的本地日志记录模式,提供了极佳的隐私保护平衡。

使用风险方面,主要集中在外部依赖可用性上:SerpAPI 服务的稳定性直接影响功能可用性,API 调用受限于用户的配额和费率。虽然技能本身实现了完善的错误处理(区分配置错误、API 错误等不同退出码),但网络延迟可能导致响应时间波动。建议生产环境用户配置多 Key 轮替,并根据实际需求评估 Airtable 存储成本。

安全解读

核心用法

serpapi-mcp 是一个封装层,通过 Model Context Protocol (MCP) 调用 SerpAPI 的搜索服务。用户可通过 /serp 命令快速执行搜索,例如 /serp "AAPL stock" google 3 compact

默认配置使用 google_light 引擎,返回 5 条精简结果;若需完整 SERP 特性(如 People Also Ask、视频包、知识图谱),建议切换至 google 引擎并启用 complete 模式。

显著优点

1. MCP 原生集成:基于开放标准的 MCP 协议,与 OpenClaw 等 MCP 客户端兼容,无需自建 HTTP 封装
2. 密钥故障转移:支持多密钥轮询(SERPAPI_API_KEYS),自动处理配额耗尽、速率限制等错误

3. 可选数据持久化:内置 Airtable 日志模块,可自动将查询、原始 JSON 及结构化摘要(Top 10 自然结果、相关问题、视频/图片)归档

4. 零第三方依赖:核心脚本仅使用 Node.js 标准库(fshttps),供应链攻击面极小

潜在缺点与局限性

  • 隐私外发:所有搜索查询均发送至 SerpAPI 服务器,敏感信息存在泄露风险
  • Airtable 配置门槛:日志功能需手动配置表结构,不支持自动建字段,且受 Airtable 单元格 90KB 大小限制
  • 网络强依赖:功能完全依赖外部 SaaS,离线不可用;SerpAPI 服务中断将直接影响可用性
  • 临时文件权限:脚本未对 mktemp 生成的临时文件设置严格权限,多用户环境存在信息泄露隐患

适合人群

  • 需要将 Google 搜索结果结构化归档的自动化工作流开发者
  • 使用 OpenClaw/Claude Desktop 等 MCP 客户端,希望直接通过对话触发搜索的用户
  • 已持有 SerpAPI 订阅、需要密钥故障转移机制的高频搜索场景

常规风险

  • 合规风险:用户搜索内容外发至第三方,需确保符合 GDPR/CCPA 等数据最小化原则
  • 凭证管理:API 密钥通过环境变量传递,虽无硬编码,但可能被同主机其他进程读取
  • 日志脱敏不足:错误输出中可能包含完整 API 端点 URL,建议启用 SERP_DEBUG 控制详细程度

serpapi-mcp 内容

scripts文件夹
手动下载zip · 9.1 kB
airtable_log.mjstext/javascript
请选择文件