serper-search

核心用法

Serper Google Search Plugin 是 Clawdbot 的原生插件，通过 Serper.dev API 提供真实 Google 搜索结果。它注册一个 serper_search 工具，支持三种搜索模式：

• 网页搜索 (searchType: "search")：返回有机搜索结果、知识图谱数据、相关问题和 "People Also Ask"
• 新闻搜索 (searchType: "news")：获取 Google News 文章，含标题、链接、摘要、日期和来源
• 可自定义结果数量（1-100 条）

显著优点

1. 真实数据源：返回未经 AI 合成的原始 Google 结果，包含完整链接和摘要
2. 免费额度充足：Serper.dev 提供 2,500 次/月的免费额度，无需绑定信用卡
3. 轻量集成：单工具调用即可获取多维数据（网页、新闻、知识图谱、相关问题）
4. 配置灵活：支持环境变量或插件配置两种方式注入 API Key
5. 与 AI 搜索互补：可与 Perplexity、Brave 等 AI 搜索工具配合使用，获取结构化原始数据

潜在缺点与局限性

• 依赖第三方 API：需 Serper.dev 账户和 API Key，存在服务可用性风险
• 非 AI 总结：仅返回原始搜索结果，无智能摘要或答案合成能力
• Clawdbot 生态绑定：专为 Clawdbot 设计，其他框架无法直接使用
• 速率限制：免费版有每月 2,500 次限制，大规模使用需付费升级

适合人群

• 需要原始 Google 数据进行自定义处理的研究者
• 开发需集成真实搜索结果的 AI 应用开发者
• 希望验证 AI 搜索工具输出、获取权威来源链接的用户
• 需要 Google News 和知识图谱数据的分析师

常规风险

• API Key 管理：需妥善保管 SERPER_API_KEY，避免泄露导致额度滥用
• 数据新鲜度：依赖 Serper.dev 的抓取频率，非实时 Google 结果
• 隐私合规：搜索查询可能包含敏感信息，需符合数据保护法规
• 服务依赖：Serper.dev 服务中断将直接影响插件功能

核心用法

Serper Google Search Plugin 是 Clawdbot 的原生插件，通过调用 Serper.dev API 返回真实 Google 搜索结果，而非 AI 生成的摘要。插件注册 serper_search 工具，支持三个参数：query（搜索词）、num（结果数 1-100，默认 5）、searchType（"search" 网页搜索或 "news" 新闻搜索）。

使用场景明确：需要带链接的原始搜索结果、获取 Google News 文章、提取知识图谱数据（快速事实、实体信息），或作为 Perplexity/Brave 等 AI 搜索工具的补充数据源。配置简单，只需在 Serper.dev 申请免费 API Key（每月 2500 次，无需信用卡），通过环境变量 SERPER_API_KEY 或直接配置传入即可。

显著优点

• 数据真实可信：直接对接 Google 搜索结果，非 LLM 合成，可溯源验证
• 覆盖全面：返回有机链接、摘要、知识图谱、"People Also Ask" 相关问题、新闻文章及来源日期
• 零成本起步：免费额度充足，个人开发者友好
• 代码质量高：TypeScript 编写，Typebox 参数验证，结构清晰，无危险函数调用
• 安全合规：API Key 通过环境变量读取，HTTPS 加密传输，无敏感信息硬编码，通过 GDPR/CCPA/数据最小化检查

潜在缺点与局限性

• 依赖外部服务：Serper.dev 服务稳定性直接影响插件可用性，存在单点故障风险
• 免费额度限制：2500 次/月对高频场景可能不足，超额需付费升级
• 功能单一：仅封装搜索 API，无本地缓存、无结果去重、无智能摘要生成
• T3 来源级别：作者为个人开发者 Samoppakiks，无组织背书，长期维护不确定性

适合人群

• 需要引用真实网页来源的研究者、内容创作者
• 构建需要可信数据源的 AI Agent 开发者
• 对 AI 生成答案存疑、希望二次验证的用户
• 轻量级搜索需求、不愿承担高昂 API 费用的个人用户

常规风险

• API Key 泄露风险：若配置不当硬编码到共享代码，可能导致额度被盗用
• 搜索内容合规：Google 返回的结果包含第三方内容，需用户自行判断可信度
• 速率限制未处理：代码未对 Serper.dev 的 429 限流响应做特殊提示，高频调用可能失败
• 隐私边界：搜索查询会传输至 Serper.dev，虽经 HTTPS 加密，但敏感信息仍应避免直接搜索