---

name: serpapi description: Search Google via SerpAPI (Google Search, Google News, Google Local). Use when you need to search the web, find news articles, or look up local businesses. Supports country/language targeting for region-specific results. metadata: {"clawdbot":{"emoji":"🔍","requires":{"bins":["curl","python3"],"env":["SERPAPI_API_KEY"]},"primaryEnv":"SERPAPI_API_KEY"}}

SerpAPI Search

Search Google via SerpAPI with country/language targeting.

Quick start

# Google Search
{baseDir}/scripts/search.sh "artificial intelligence B2B" --country br --lang pt

# Google News
{baseDir}/scripts/search.sh "inteligência artificial" --engine google_news --country br --lang pt

# Google Local
{baseDir}/scripts/search.sh "AI companies" --engine google_local --country us --location "San Francisco, California"

Engines

Engine	Use case	Key results field
google	Web search (default)	organic_results
google_news	News articles	news_results
google_local	Local businesses/places	local_results

Options

Flag	Description	Default
--engine	google, google_news, google_local	google
--country	2-letter country code (br, us, de, etc.)	us
--lang	Language code (pt, en, es, etc.)	en
--location	Location string (e.g. "São Paulo, Brazil")	—
--num	Number of results	10
--json	Raw JSON output	off

API key

Set SERPAPI_API_KEY env var, or store it:

mkdir -p ~/.config/serpapi
echo "your_key_here" > ~/.config/serpapi/api_key
chmod 600 ~/.config/serpapi/api_key

Common country codes

br (Brazil), us (USA), pt (Portugal), de (Germany), fr (France), es (Spain), gb (UK), jp (Japan), in (India).