search_and_fetch
Combine search and page extraction into one round-trip. Returns ranked results with full-page excerpts, citations, and optional browser rendering for dynamic content.
Instructions
Search SearXNG for one query and fetch+extract the top results in a single call. Combines search and fetch_many for one-query research workflows.
Best for: answering one question that needs evidence from full pages, building a citation-backed answer to a single prompt, getting both ranked results and readable excerpts in one round-trip.
Returns: search summary plus per-source {title, url, excerpt, citations, render_mode}. The full SearXNG payload and per-page full text are in hidden _meta.
Rendered fetch is automatic for JS-heavy pages; pass rendered=true to force browser mode (slower).
Use search if extraction is not needed; research for multi-query investigations.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query (1–400 chars). Plain text or SearXNG syntax. SearXNG bangs like '!wikipedia foo' or '!images cats' are supported and route to specific engines. | |
| categories | No | Comma-separated SearXNG categories to search (e.g. 'general', 'news', 'images', 'videos', 'science', 'files'). Default is the server's configured category set, typically 'general'. | |
| engines | No | Comma-separated SearXNG engine names to use for this query. Forwarded to SearXNG's 'engines' parameter. Leave unset to use the backend's default engine selection. | |
| enabled_engines | No | Comma-separated engine names to enable in addition to the backend defaults. Forwarded as SearXNG's 'enabled_engines' parameter. | |
| disabled_engines | No | Comma-separated engine names to exclude from this query. Forwarded as SearXNG's 'disabled_engines' parameter. | |
| language | No | BCP-47 language hint for SearXNG (e.g. 'en', 'en-US', 'de', 'all'). Default is the server's configured language. | |
| pageno | No | Result page number (1–20, default 1). Use to paginate beyond the first page. | |
| time_range | No | Restrict results to recent content. Valid values: 'day', 'week', 'month', 'year'. Omit for no time filter. | |
| safesearch | No | Safe search level: 0=off, 1=moderate, 2=strict. Omit to use the server default. | |
| max_results | No | Maximum visible results to include in the compact summary (1–50). Default comes from server settings (typically 5). The hidden `_meta.raw_payload.results` always contains the full SearXNG response regardless of this cap. | |
| fetch_limit | No | Maximum number of search results to fetch and extract (1–20, default 3). Lower is faster; higher gives more sources at the cost of latency. | |
| fetch_excerpt_chars | No | Per-source excerpt character cap (200–20000). Default comes from server settings. Smaller values keep the visible output tight; the full text is always available in hidden `_meta` for each source. | |
| rendered | No | Force browser-based rendering for fetches. Default false: the server auto-renders only when a page is JS-heavy or returns near-empty text. Set true when a previous fetch came back nearly empty or to read a known SPA. Forced rendering is several times slower than HTTP fetch. | |
| render_wait_ms | No | Extra milliseconds to wait after DOM content load before extracting (0–15000). Use a higher value (e.g. 1500–4000) for SPAs that hydrate slowly. | |
| ttl | No | Cache TTL override in seconds (0–86400). 0 disables caching for this call. Omit to use the server's default TTL. |