search
Perform web queries against a SearXNG instance, returning structured results with titles, URLs, snippets, and engine metadata, with filters for categories, language, time, and safety.
Instructions
Search the web via the configured SearXNG instance.
Args:
query: The search query string. Required.
categories: SearXNG category list, e.g. ["general"], ["images"].
Defaults to the server's `SEARXNG_DEFAULT_CATEGORY`.
engines: Restrict to specific engines, e.g. ["google", "bing"].
language: Language code, e.g. "en", "de". Defaults to server setting.
pageno: Page number (1-indexed). Default 1.
time_range: One of "day", "month", "year", or None.
safesearch: 0 (none), 1 (moderate), 2 (strict). Defaults to server setting.
max_results: Cap on results returned (1-50). Default 10.
Returns:
Dict with `results` (list of {title, url, snippet, engine, score}),
`suggestions`, `number_of_results`, and on error an `error` field.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ctx | No | ||
| query | Yes | ||
| pageno | No | ||
| engines | No | ||
| language | No | ||
| categories | No | ||
| safesearch | No | ||
| time_range | No | ||
| max_results | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||