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)

   7w4.net提供免费和付费技能下载。

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

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 密钥才能使用。整体而言是一个功能明确、可用性良好的搜索工具插件。