核心用法
serpapi-mcp 是一个封装型技能，通过 mcporter 在 Clawdbot 内部调用 SerpAPI 的 MCP 服务器。核心交互方式为 /serp 命令，支持灵活的查询参数配置。
基础语法：
/serp <查询内容> [搜索引擎] [结果数量] [输出模式]
engine：默认google_light，支持切换其他 SerpAPI 支持的引擎num：默认返回 5 条结果，可自定义数量mode：compact（精简，默认）或complete（完整原始数据）
典型用例：
- 站内搜索：
/serp site:cnmv.es "educación financiera" - 股票信息：
/serp "AAPL stock" google 3 compact - 天气查询：
/serp "weather in Madrid" google 1 complete
底层调用 skills/serpapi-mcp/scripts/serp.sh 脚本，最终请求 https://mcp.serpapi.com/$SERPAPI_API_KEY/mcp.search 端点，返回标准 SerpAPI JSON 格式（含 organic_results、news_results 等字段，因引擎而异）。
显著优点
1. 即开即用：封装了 MCP 协议细节，用户仅需环境变量配置即可使用
2. 结构化输出：返回标准化 JSON，便于下游解析和自动化处理
3. 多引擎支持：不限于 Google，可灵活切换 SerpAPI 支持的各类搜索引擎
4. 模式切换：compact 模式减少 Token 消耗，complete 模式保留完整元数据
5. Clawdbot 原生集成：通过 mcporter 实现与对话上下文的深度结合
潜在局限
1. 外部依赖：必须持有有效 SerpAPI API Key，且受 SerpAPI 服务可用性制约
2. 成本敏感：SerpAPI 按调用量计费，高频使用需关注配额消耗
3. 结果时效性：依赖搜索引擎索引，非实时抓取，存在延迟
4. 地理限制：部分引擎结果受 IP 地理位置和搜索参数影响
5. 无内置缓存：重复查询会重复计费，未提供结果缓存机制
适合人群
- 需要实时网络信息增强的 AI 对话用户
- 依赖结构化搜索数据进行自动化分析的开发者
- 希望在不离开 Clawdbot 环境的情况下快速验证网络信息的用户
常规风险
- API Key 泄露风险：
SERPAPI_API_KEY需妥善保管，建议仅通过 Clawdbot gateway 的env.vars注入，避免硬编码 - 账单失控：未设置调用上限可能导致意外费用，建议在 SerpAPI 控制台配置用量预警
- 结果可靠性：搜索引擎结果可能包含 SEO 操控内容或过时信息，关键决策需交叉验证
- 隐私合规：搜索查询内容可能传输至 SerpAPI 服务器，敏感信息检索需注意数据出境合规要求