serper-search

The plugin registers a serper_search tool with three parameters:

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | query | string | required | The search query | | num | number | 5 | Number of results (1-100) | | searchType | string | "search" | "search" for web, "news" for news |

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.

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
        }
      }
    }
  }
}