Serper Web Search

Performs Google web searches using the Serper API and returns structured search results when provided a valid Serper API key.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install serper-web-search

Serper Search

Use Serper API for Google search results.

API Details

Endpoint: https://google.serper.dev/search
Method: POST
Headers: X-API-Key: $SERPER_API_KEY, Content-Type: application/json
Body: {"q": "your query here"}

Usage

With API Environment Key in

SERPER_API_KEY="your-key" curl -s -X POST "https://google.serper.dev/search" \
  -H "X-API-Key: $SERPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "your query"}'

With Inline Key

curl -s -X POST "https://google.serper.dev/search" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "your query"}'

Script

Use the bundled search script:

./scripts/search "your query"

Response Format

Returns JSON with:

organic[] - Search results (title, link, snippet)
searchParameters.q - Original query
credits - Credits used

Example result:

{
  "searchParameters": {"q": "test", "type": "search"},
  "organic": [
    {"title": "Result Title", "link": "https://...", "snippet": "Description...", "position": 1}
  ],
  "credits": 1
}

Getting an API Key

Visit https://serper.dev
Sign up for an account
Get your API key from the dashboard
Set SERPER_API_KEY environment variable or pass the key inline