Google Serper Search
This skill enables you to search the web and find images using the Serper API.
When to Use This Skill
Use this skill when the user:
- Asks to search for information online
- Needs current/recent information not in your knowledge base
- Requests to find images or pictures
- Wants to verify facts or get latest updates
- Asks questions that require web search
How to Use
Advanced Search
You can now use advanced parameters to filter results.
python3 scripts/serper_search.py "query" --type news --gl us --hl en --tbs "past week"
Parameters:
- Type (
--type): search, images, videos, places, maps, reviews, news, shopping, lens, scholar, patents, autocomplete.
- Country (
--gl): 2-letter country code (e.g., us, cn, jp, gb).
- Language (
--hl): Google language code (e.g., en, zh-cn, zh-tw, ja).
- Date range (
--tbs): past hour, past 24 hours, past week, past month, past year.
The script returns JSON with:
knowledgeGraph: Key facts about the topic
organic: Search results with title, link, and snippet
peopleAlsoAsk: Related questions
relatedSearches: Related search terms
Image Search
When the user needs images, run:
python3 scripts/serper_search.py "search query" --type images
Returns JSON with image URLs, thumbnails, dimensions, and sources.
Response Format
After getting search results:
- Parse the JSON response
- Present results in a clear, organized format
- Include relevant links and sources
- For images, describe what was found and provide image URLs
Example Usage
User: "Search for the latest news about AI"
You: Use Bash tool to run the search script, then format and present the results.
User: "Find pictures of mountains"
You: Use Bash tool to run image search, then present the image URLs and descriptions.
1---2name: google-serper-search3description: This skill should be used when the user asks to "search the web", "search for information", "find information online", "search Google", "search for images", "find pictures", or requests any web search or image search functionality.4---5
6# Google Serper Search
7
8This skill enables you to search the web and find images using the Serper API.
9
10## When to Use This Skill
11
12Use this skill when the user:
13- Asks to search for information online
14- Needs current/recent information not in your knowledge base
15- Requests to find images or pictures
16- Wants to verify facts or get latest updates
17- Asks questions that require web search
18
19## How to Use
20
21### Advanced Search
22
23You can now use advanced parameters to filter results.
24
25```bash
26python3 scripts/serper_search.py "query" --type news --gl us --hl en --tbs "past week"
27```
28
29#### Parameters:
30- **Type (`--type`)**: search, images, videos, places, maps, reviews, news, shopping, lens, scholar, patents, autocomplete.
31- **Country (`--gl`)**: 2-letter country code (e.g., `us`, `cn`, `jp`, `gb`).
32- **Language (`--hl`)**: Google language code (e.g., `en`, `zh-cn`, `zh-tw`, `ja`).
33- **Date range (`--tbs`)**: `past hour`, `past 24 hours`, `past week`, `past month`, `past year`.
34
35The script returns JSON with:
36- `knowledgeGraph`: Key facts about the topic
37- `organic`: Search results with title, link, and snippet
38- `peopleAlsoAsk`: Related questions
39- `relatedSearches`: Related search terms
40
41### Image Search
42
43When the user needs images, run:
44
45```bash
46python3 scripts/serper_search.py "search query" --type images
47```
48
49Returns JSON with image URLs, thumbnails, dimensions, and sources.
50
51## Response Format
52
53After getting search results:
541. Parse the JSON response
552. Present results in a clear, organized format
563. Include relevant links and sources
574. For images, describe what was found and provide image URLs
58
59## Example Usage
60
61User: "Search for the latest news about AI"
62You: Use Bash tool to run the search script, then format and present the results.
63
64User: "Find pictures of mountains"
65You: Use Bash tool to run image search, then present the image URLs and descriptions.