Serper Google 搜索插件

Clawdbot 原生插件，通过 Serper.dev API 实现 Google 搜索。以单一工具调用的形式返回真实的 Google 搜索结果，包括：自然链接、知识图谱、新闻和“用户还问了以下问题”。

使用场景

• 需要获取带有链接和摘要的真实 Google 搜索结果（而非 AI 生成的答案）
• 希望查找关于某个主题的 Google 新闻文章
• 需要知识图谱数据（快速事实、实体信息）
• 作为 AI 搜索工具（如 Perplexity、Brave）的补充，提供原始 Google 数据

设置

1. 在 serper.dev 获取免费 API 密钥（每月 2500 次搜索，无需信用卡）
2. 在 Clawdbot 配置中设置环境变量：

{
  "env": {
    "vars": {
      "SERPER_API_KEY": "在此处填写你的 API 密钥"
    }
  }
}

或者直接在插件入口中配置：

{
  "plugins": {
    "entries": {
      "serper-search": {
        "enabled": true,
        "config": {
          "apiKey": "在此处填写你的 API 密钥",
          "defaultNumResults": 5
        }
      }
    }
  }
}

使用方法

插件注册了一个名为 serper_search 的工具，包含三个参数：

网页搜索

搜索 "2026 年最佳 Rust Web 框架"

返回包含标题、链接、摘要和排名的自然搜索结果，以及知识图谱和相关问题。

新闻搜索

搜索关于 "欧洲 AI 监管" 的新闻

返回包含标题、链接、摘要、日期和来源的新闻文章。

插件结构

serper-search/
  clawdbot.plugin.json   # 插件清单，包含配置模式
  package.json           # NPM 包配置
  index.ts               # 插件实现代码
  SKILL.md               # 本文档

关键实现细节

• 导出方式：export default function register(api) — 直接导出函数，而非对象
• 工具注册：api.registerTool(toolObject) — 直接注册，无需回调
• 返回格式：{ content: [{ type: "text", text: JSON.stringify(results) }] }
• 依赖项：从 Clawdbot 自身的 node_modules 中符号链接 @sinclair/typebox

作者

由 @Samoppakiks 使用 Claude Code 构建。