核心用法
serpapi-mcp 是一个基于 Model Context Protocol (MCP) 的搜索封装技能，通过 mcporter CLI 调用 SerpAPI 的 MCP 服务器执行实时网页搜索。用户可通过 /serp 命令快速触发搜索，支持自定义搜索引擎（google/google_light）、结果数量及输出模式（compact/complete）。
典型调用方式：
/serp "AAPL stock" google 3 compact— 获取苹果股票的精简结果/serp "mortgage pay off vs invest" google 10 complete— 完整模式获取知识图谱、PAA、视频等多维数据
显著优点
1. MCP 协议原生集成：相比传统 HTTP API 调用，MCP 提供了标准化的工具描述与上下文管理能力，便于 AI 助手自动发现并调用搜索能力。
2. 丰富的结构化输出：完整模式可返回自然结果、短视频、图片、相关知识问答（PAA）、知识图谱、AI 概览等多维度数据，满足深度信息挖掘需求。
3. 智能密钥故障转移：支持多密钥轮询（SERPAPI_API_KEYS），在配额耗尽、速率限制或认证失败时自动切换，提升服务可用性。
4. 可选 Airtable 持久化：自动将搜索日志、原始 JSON 及结构化摘要写入 Airtable，支持字段级类型感知与截断保护，便于构建私有搜索数据库。
潜在缺点与局限性
- 外部依赖较重：需预装
mcporterNode.js 包，且依赖 SerpAPI 商业服务（按调用量计费），存在持续成本。 - Airtable schema 刚性：日志功能要求目标表预定义字段，无法自动创建；若字段缺失则静默跳过，需人工维护表结构。
- 单单元大小限制：Airtable 单元格存在 ~100KB 文本上限，超大 JSON 会被截断并标记，可能影响数据完整性追溯。
- 搜索引擎限制：虽名义支持 SerpAPI 多引擎，但当前配置主要优化 Google/Google Light，其他引擎（Bing、Yahoo 等）支持程度未明确。
适合人群
- 金融/法律/咨询研究员：需要高频实时搜索并归档结构化结果
- AI 应用开发者：希望为 Agent 快速添加合规、可审计的搜索能力
- 数据分析师：希望将搜索行为与结果自动同步至 Airtable 进行后续 ETL
常规风险
- API 密钥泄露：
SERPAPI_API_KEY需妥善保管，避免硬编码在仓库中；建议通过 Gateway 环境变量注入。 - 成本失控：SerpAPI 按搜索次数计费，高频调用场景需配置配额监控与密钥池熔断机制。
- 数据合规：Airtable 日志可能包含敏感查询词与搜索结果，需确认符合组织数据留存与跨境传输政策。