Web Search
infobroker_search_webSearch the web, encyclopedia, academic, and code sources through one interface with automatic provider selection and a fallback chain.
Instructions
Search the web, encyclopedia, academic, and code sources through one interface with automatic provider selection and a fallback chain. Use when you need broad or batched search, query autocomplete (suggest), query expansion (expand), ranked passages from the top pages (deep), or a multi-variant research compile that deep-reads each variant (research), and optional in-process analysis of the returned results (analyze: topics, entities, clusters, timeline). Do NOT use for a URL you already have (use infobroker_fetch_page), for high-stakes claim verification (use infobroker_verify_claims), for stored-report recall (use infobroker_manage_kb search), or for academic citations (use infobroker_get_citations). Caches results in the local knowledge base, enforces per-provider rate limits, and needs no API key for the free providers. task_type forces a dispatch chain (for example academic) when the automatic classification picks the wrong one. fresh: false keeps KB-first sufficiency, fresh: true skips KB recall and searches external providers, and fresh: 'blend' keeps cached KB results alongside fresh external results. collection scopes KB recall to a named collection. audience records who will read the result and is echoed in meta.direction with the executed task type, reading depth, result bound and provider pool. When two task types are equally supported and would reach different providers, the tool returns both candidate requirements with an empty result list (meta.direction.ambiguous) instead of searching, so the caller can re-issue with task_type. include_domains restricts results to or prefers listed domains (include_domains_mode: restrict filters, prefer ranks them ahead), on top of the configured blocklist; the response reports the matched and excluded counts. An array query is searched in parallel and merged, and a failed element is reported in meta.per_query without failing the batch. A measurable attribute (attendance, population, area, elevation, percentage, date) returns a sourced facts entry before prose, with meta.fact_status. Returns a JSON envelope prefixed [OK] or [ERROR] with status, provider, results, and meta.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "infobroker_search_web"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deep | No | Read the top results and return each page's ranked passages against the query | |
| page | No | Results page number (default 1) | |
| fresh | No | Knowledge-base recall mode: false keeps KB-first sufficiency, true skips recall and searches external providers, blend keeps KB results alongside fresh external results (default false) | |
| query | Yes | Search query: a single string, or up to five strings searched in parallel | |
| expand | No | Return query-expansion strings instead of search results | |
| region | No | ISO region/country code (e.g. 'us-en', 'DE') | |
| analyze | No | Attach in-process analysis to the response: topic terms, entity mentions, semantic result clusters, and a dated timeline. Derived from the returned results only; adds no outbound request (default false) | |
| suggest | No | Return query-autocomplete strings instead of results (default false) | |
| audience | No | Who will read the result: executive, analyst, engineer, policy, legal, journalist, or investor. Recorded in the direction block and carried into a report manifest; it calibrates depth and emphasis, never facts | |
| language | No | Preferred result language (ISO 639-1, e.g. 'de'). Providers that cannot honor it report it in meta.ignored_params | |
| priority | No | Route by intent: speed, quality, privacy, or free_only | |
| provider | No | Provider slug (auto-select if omitted) | |
| research | No | Research compile: fan out to derived query variants and deep-read each, returning passages grouped by variant (default off) | |
| task_type | No | Force a dispatch chain by task type (auto-classified when omitted) | |
| collection | No | Knowledge-base collection to recall from (scopes KB recall only; ignored when fresh is true) | |
| time_range | No | Restrict results to day, week, month, or year | |
| max_results | No | Number of results to return (1-30, default 8) | |
| safe_search | No | Safe-search filtering: on, off, or strict (default on) | on |
| content_type | No | Source kind to search: docs, issue, changelog, blog, spec, or all (default all) | all |
| include_domains | No | Domains to restrict or prefer (max 300). Matching is case-insensitive and a domain matches its subdomains; an empty list is a no-op | |
| include_domains_mode | No | How include_domains applies: restrict returns only matching hosts, prefer ranks them ahead without excluding any (default restrict) | restrict |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| error | No | ||
| status | Yes | ||
| notices | No | ||
| results | No | ||
| provider | Yes |