shuliuzhenhua-sys/google-serper-search
Overview
This skill lets you search the web and find images using the Serper API. It provides structured JSON results for web queries (knowledge graph, organic results, related searches) and image searches (image URLs, thumbnails, dimensions, sources). Use it to fetch current or recent information and to retrieve images with source links.
How this skill works
The skill runs a Python script that calls the Serper API with your query and search type (web or images). It returns a JSON payload containing key facts, ranked organic results, related questions, and image metadata. After receiving results, parse the JSON, extract relevant links and snippets, and present them in a clear, organized format with sources.
When to use it
- User asks to search the web for current information or news
- User requests verification of facts or recent updates beyond the knowledge cutoff
- User asks to search Google or perform a general web search
- User requests image search or asks to find pictures
- User wants related search terms or people-also-ask suggestions
Best practices
- Prefer web mode for factual updates, news, and long-form sources; prefer images mode for photos and graphics
- Always include source links and short snippets or captions for each result
- Parse the knowledgeGraph first for concise facts, then show top organic results for depth
- Limit results to the most relevant items and provide a brief summary for each
- Respect API key confidentiality and load keys from secure environment variables
Example use cases
- Search for the latest news about a technology, company, or public figure and present top articles with links
- Find images of a landmark or product and return image URLs, thumbnails, and source pages
- Verify a recent claim by retrieving multiple authoritative sources and summarizing consensus
- Provide related search suggestions and people-also-ask items to help refine a follow-up query
- Gather quick facts from the knowledge graph to populate a short summary or answer
FAQ
Yes. The Serper API key must be provided via environment variable before running the search script.
What formats are returned?
The skill returns structured JSON: knowledgeGraph, organic results, peopleAlsoAsk, relatedSearches for web; image URLs, thumbnails, dimensions, and sources for images.
