Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Google web search via Gemini Search Grounding (primary) and Custom Search JSON API (fallback). Use for: (1) Synthesized answers with citations (grounded sear...
Google web search via Gemini Search Grounding (primary) and Custom Search JSON API (fallback). Use for: (1) Synthesized answers with citations (grounded sear...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Google web search powered by Gemini 2.5 Flash with Search Grounding + Custom Search API. โญ This is the PRIMARY web search tool. Prefer over built-in web_search (Perplexity).
GOOGLE_API_KEY environment variable Enable in Google Cloud Console: Gemini API, Custom Search JSON API
Env VariableDefaultDescriptionGOOGLE_API_KEYโRequired. Google API keyGOOGLE_CSE_CXโCustom Search Engine ID (required for raw/image modes)GOOGLE_SEARCH_LANGheDefault language code (he, en, ar, ja, etc.)GOOGLE_SEARCH_COUNTRYILDefault country code (IL, US, DE, etc.) Set in OpenClaw config: { "env": { "GOOGLE_API_KEY": "AIza...", "GOOGLE_SEARCH_LANG": "he", "GOOGLE_SEARCH_COUNTRY": "IL" } }
python3 skills/google-search/lib/google_search.py <mode> "query" [options]
Text mode (default): Best for most use cases. Clean readable output with answer, sources, and search queries. JSON mode (--json): For programmatic processing. Includes confidence scores, grounding supports, and search queries.
Gemini 2.0 Flash + Google Search tool โ synthesized answer with numbered citations. python3 lib/google_search.py search "query" [--lang he] [--country IL] [--json] When to use: Questions, current events, "what is X", Hebrew queries, anything needing a direct answer. Examples: # Hebrew (default) python3 lib/google_search.py search "ืืื ืืืืืจ ืชื ืืืื" # English override python3 lib/google_search.py search "latest AI news" --lang en --country US # JSON output python3 lib/google_search.py search "OpenAI GPT-5 release date" --json Output format: <Synthesized answer text> Sources: 1. Source Title https://example.com/article 2. Another Source https://example.com/other
Custom Search JSON API โ links with titles and snippets. python3 lib/google_search.py raw "query" [-n 5] [--lang he] [--country IL] [--json] When to use: Need actual URLs, research, building reference lists, when you want links not answers. Examples: python3 lib/google_search.py raw "python asyncio tutorial" -n 5 python3 lib/google_search.py raw "best restaurants tel aviv" --json python3 lib/google_search.py raw "rust vs go performance" -n 3 --lang en Output format: 1. Page Title https://example.com/page Brief snippet from the page... 2. Another Page https://example.com/other Another snippet...
Custom Search image search โ image URLs with titles. python3 lib/google_search.py image "query" [-n 5] [--lang he] [--country IL] [--json] When to use: Finding images, visual references, thumbnails. Examples: python3 lib/google_search.py image "aurora borealis" -n 5 python3 lib/google_search.py image "ืชื ืืืื ืืืฃ" --json
OptionApplies ToDescriptionDefault--lang CODEallLanguage code (he, en, ar, jaโฆ)env GOOGLE_SEARCH_LANG (he)--country CODEallCountry code (IL, US, DEโฆ)env GOOGLE_SEARCH_COUNTRY (IL)-n NUMraw, imageNumber of results (1โ10)10--jsonallStructured JSON outputoff Language resolution order: --lang flag โ GOOGLE_SEARCH_LANG env โ None (auto) Country resolution order: --country flag โ GOOGLE_SEARCH_COUNTRY env โ None (auto)
Missing API key: Clear error message with setup instructions. 429 Rate Limit: Automatic retry once after 5-second wait. Network errors: Descriptive error with cause. No results: Clean "No results found." message. Timeout: 30-second timeout on all HTTP requests.
APIFree TierRate LimitGemini API (grounded search)Generous free tier~15 RPM (free), higher on paidCustom Search JSON API (raw/image)100 queries/day10K queries/day (paid) On 429 errors: Script retries once automatically. If quota exhausted, fall back to built-in web_search (Perplexity).
Works with queries in any language. Hebrew is the default: # Hebrew (default, no flags needed) python3 lib/google_search.py search "ืืืฉืืช ืืื ืืืืืื" # English python3 lib/google_search.py search "technology news" --lang en # Arabic python3 lib/google_search.py search "ุฃุฎุจุงุฑ ุงูุชูููููุฌูุง" --lang ar
bash skills/google-search/install.sh
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.