🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί serper-search
πŸ¦€ ClawHub

serper-search

by @samoppakiks

Fetches real Google search or news results with links, snippets, knowledge graph data, and related questions via the Serper.dev API.

Versionv1.0.0
Downloads3,054
Installs22
Stars⭐ 2
#seo#legal
TERMINAL
clawhub install serper-search

πŸ“– About This Skill

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:

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

    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.

    ⚑ When to Use

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

    πŸ’‘ Examples

    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.

    βš™οΈ Configuration

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