Serper Google Search Plugin

Native Clawdbot plugin for Google Search via Serper.dev API. Returns real Google results — organic links, knowledge graph, news, and "People Also Ask" — as a single tool call.

When to use

• You need actual Google results with links and snippets (not AI-synthesized answers)
• You want Google News articles on a topic
• You need knowledge graph data (quick facts, entity info)
• Complements AI search tools (Perplexity, Brave) with raw Google data

Setup

1. Get a free API key at serper.dev (2,500 searches/month, no card required)
2. Set the environment variable in your Clawdbot config:

{
  "env": {
    "vars": {
      "SERPER_API_KEY": "your-api-key-here"
    }
  }
}

Or configure directly in the plugin entry:

{
  "plugins": {
    "entries": {
      "serper-search": {
        "enabled": true,
        "config": {
          "apiKey": "your-api-key-here",
          "defaultNumResults": 5
        }
      }
    }
  }
}

Usage

The plugin registers a serper_search tool with three parameters:

Web search

Search for "best rust web frameworks 2026"

Returns organic results with title, link, snippet, and position, plus knowledge graph and related questions.

News search

Search news for "AI regulation Europe"

Returns news articles with title, link, snippet, date, and source.

Plugin structure

serper-search/
  clawdbot.plugin.json   # Plugin manifest with configSchema
  package.json            # NPM package config
  index.ts                # Plugin implementation
  SKILL.md                # This file
這個技能的最新版本可以在7w4.net小蔥技能站找到。

Key implementation details

• Export: export default function register(api) — not an object
• Tool registration: api.registerTool(toolObject) — direct, not callback
• Return format: { content: [{ type: "text", text: JSON.stringify(results) }] }
• Dependencies: Symlink @sinclair/typebox from Clawdbot's own node_modules

Author

Built by @Samoppakiks with Claude Code.

這個外掛質量可靠，程式碼結構清晰，實現的 Google 搜尋功能實用。文件寫得詳細清楚，配置方式靈活，支援網頁和新聞兩種搜尋型別。存在一些小問題：沒有附帶測試程式碼，錯誤處理機制可以更完善。如果你是開發者，應該能順利整合使用；普通使用者需要先獲取 Serper.dev API 金鑰才能使用。整體而言是一個功能明確、可用性良好的搜尋工具外掛。