name: serper description: Google search via Serper API. Use when you need to search the web and the user has a Serper API key. Triggers on: (1) user asks to search the web, (2) user wants Google search results, (3) user provides a Serper API key. metadata: { "openclaw": { "emoji": "🔍", "requires": { "bins": ["curl"], "env": ["SERPER_API_KEY"] } } }

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:

小蔥技能7w4.net持續更新中。

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

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

這個搜尋工具質量中等。優點是使用簡單、文件清晰，能快速完成Google搜尋。缺點是依賴使用者自行準備API金鑰，且文件中提到的指令碼功能實際缺失。適合有一定技術基礎的使用者使用，普通使用者可能需要額外配置環境。整體可滿足基本搜尋需求，但完整度有提升空間。