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:

1. Parse the JSON response
2. Present results in a clear, organized format
3. Include relevant links and sources
4. 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.