Universal search tool supporting all SerpApi engines and result types.
When to use:
- Any query needing live, structured SERP data: web results, news, product listings, job postings, local businesses, flight/hotel prices, video results, images, stock/weather cards, knowledge graph entities.
Engine discovery via MCP resources:
- serpapi://engines lists all engines supported by this tool.
- serpapi://engines/<engine> provides engine-specific parameters and supported options.
- Example: serpapi://engines/google_news
Input schema:
params: JSON object containing SerpApi engine parameters.
Common parameters:
- q: Search query. Required for most engines.
- engine: SerpApi engine name. Defaults to "google_light".
- location: Optional geographic location for localized results.
- output: Optional response format. Omit for JSON (default), or set to "md" for Markdown.
Engine-specific parameters are available via MCP resources:
- serpapi://engines lists all supported engines.
- serpapi://engines/<engine> provides parameters and options for one engine.
mode: Response mode. Defaults to "complete".
- "complete": Return the full SerpApi response.
- "compact": Remove metadata fields from JSON responses. Markdown is returned unchanged.
Output schema:
structuredContent.result contains the response string: serialized JSON or unchanged Markdown.
The same string is included in text content. Tool failures preserve this wrapper and set isError to true.
Guided search:
Searches can request missing engine parameters from supporting clients using the engine catalog and engine-specific rules.
Flights collect airports and dates, hotels collect the destination and stay dates, and directions collect missing endpoints.
Other clients receive a missing-parameter error. Cancellation does not run a search.
Examples:
Weather: {"params": {"q": "weather in London", "engine": "google"}, "mode": "complete"}
Stock: {"params": {"q": "AAPL stock", "engine": "google"}, "mode": "complete"}
General: {"params": {"q": "coffee shops", "engine": "google_light", "location": "Austin, TX"}, "mode": "complete"}
Compact: {"params": {"q": "news"}, "mode": "compact"}
Markdown: {"params": {"q": "news", "output": "md"}}
Supported engines include (not limited to):
- google
- google_light
- google_flights
- google_hotels
- google_images
- google_news
- google_local
- google_shopping
- google_jobs
- bing
- yahoo
- duckduckgo
- youtube_search
- baidu
- ebay
