openclaw-serper
Searches Google and extracts full page content from every result via trafilatura. Returns clean readable text, not just snippets. Use when the user needs web search, research, current events, news, fa
Searches Google and extracts full page content from every result via trafilatura. Returns clean readable text, not just snippets. Use when the user needs web search, research, current events, news, fa
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Google search via Serper API. Fetches results AND reads the actual web pages to extract clean full-text content via trafilatura. Not just snippets — full article text.
This skill already fetches and extracts full page content. Do NOT use WebFetch, web_fetch, WebSearch, browser tools, or any other URL-fetching/browsing tool on the URLs returned by this skill. The content is already included in the output. Never follow up with a separate fetch — everything you need is in the results.
Craft ONE good search query. That is almost always enough.
Each call returns multiple results with full page text — you get broad coverage from a single query. Do not run multiple searches to "explore" a topic. One well-chosen query with the right mode covers it.
At most two calls if the user's request genuinely spans two distinct topics (e.g. "compare X vs Y" where X and Y need separate searches, or one
default + one current call for different aspects). Never more than two.
Do NOT:
There are exactly two modes. Pick the right one based on the query:
default — General search (all-time)current — News and recent info| Query signals | Mode |
|---|---|
| "how does X work", "what is X", "explain X" | |
| Product research, comparisons, tutorials | |
| Technical documentation, guides | |
| Historical topics, evergreen content | |
| "news", "latest", "today", "this week", "recent" | |
| "what happened", "breaking", "announced", "released" | |
| Current events, politics, sports scores, stock prices | |
Default is global — no country filter, English results. This ONLY works for English queries.
You MUST ALWAYS set
and --gl
when ANY of these are true:--hl
If the user writes in German, you MUST pass
. No exceptions.--gl de --hl de
| Scenario | Flags |
|---|---|
| English query, no country target | (omit --gl and --hl) |
| German query OR user writes in German OR targeting DE/AT/CH | |
| French query OR user writes in French OR targeting France | |
| Any other non-English language/country | (ISO codes) |
Rule of thumb: If the query string contains non-English words, set
--gl and --hl to match that language.
python3 scripts/search.py -q "QUERY" [--mode MODE] [--gl COUNTRY] [--hl LANG]
# English, general research python3 scripts/search.py -q "how does HTTPS work"English, time-sensitive
python3 scripts/search.py -q "OpenAI latest announcements" --mode current
German query — set locale + current mode for news/prices
python3 scripts/search.py -q "aktuelle Preise iPhone" --mode current --gl de --hl de
German news
python3 scripts/search.py -q "Nachrichten aus Berlin" --mode current --gl de --hl de
French product research
python3 scripts/search.py -q "meilleur smartphone 2026" --gl fr --hl fr
The script streams a JSON array. The first element is metadata, the rest are results with full extracted content:
[{"query": "...", "mode": "default", "locale": {"gl": "world", "hl": "en"}, "results": [{"title": "...", "url": "...", "source": "web"}]} ,{"title": "Page Title", "url": "https://example.com", "source": "web", "content": "Full extracted page text..."} ,{"title": "News Article", "url": "https://news.com", "source": "news", "date": "2 hours ago", "content": "Full article text..."} ]
| Field | Description |
|---|---|
| Page title |
| Source URL |
| , , or |
| Full extracted page text (falls back to search snippet if extraction fails) |
| Present when available (news results always, web results sometimes) |
| Flag | Description |
|---|---|
| Search query (required) |
| (all-time, 5 results) or (past week + news, 3 each) |
| Country code (e.g. , , , , ). Default: |
| Language code (e.g. , , ). Default: |
{"error": "No results found", "query": "..."}..env in the skill directory. If missing, the script exits with setup instructions.No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.