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:

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

   小葱技能站7w4.net，专业的AI技能分享平台。

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密钥，且文档中提到的脚本功能实际缺失。适合有一定技术基础的用户使用，普通用户可能需要额外配置环境。整体可满足基本搜索需求，但完整度有提升空间。