Web Search
Category: Integration
Node id: web-search
Performs web searches via SearchXNG with support for general, medical, academic, and news categories
What it does
- Web search via SearchXNG with multiple categories
- Medical, academic, news, and general search modes
- Result caching with configurable TTL (5 minutes)
- Multi-engine search aggregation
- Safe search filtering
- Configurable result limits and language
Use cases
- Searching medical literature and clinical guidelines
- Retrieving academic papers for evidence-based analysis
- Gathering news articles for health policy monitoring
- Augmenting RAG pipelines with real-time web knowledge
Runtime
- Performance tier:
variable
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
query | text | No | Search query string (overrides config) |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
results | json | No | Array of search results with title, url, content, engine, and score |
total | number | No | Number of results returned |
query | text | No | Search query used |
cached | boolean | No | Whether the results came from cache |
search_url | text | No | Full SearchXNG URL used |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Query | query | string | No | Default search query (used if no query input) | ||
| Operation | operation | enum | No | search | search, search_medical, search_academic, search_news | Search category/operation |
| Max Results | max_results | number | No | 10 | min 0 | Maximum number of results to return |
| Language | language | string | No | en | Search language code | |
| Safe Search | safesearch | number | No | 1 | min 0; max 2 | Safe search level (0=off, 1=moderate, 2=strict) |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Engines | engines | string | No | Comma-separated list of search engines to use | ||
| Timeout (seconds) | timeout | number | No | 10 | min 1 | Search request timeout in seconds |
| SearchXNG URL | searchxng_url | string | No | http://localhost:8888 | Base URL of the SearchXNG instance |
Errors
| Code | Description |
|---|---|
QUERY_REQUIRED | No search query provided via input or config |
SEARCHXNG_UNREACHABLE | Cannot connect to the SearchXNG instance |
HTTP_ERROR | SearchXNG returned a non-2xx HTTP status |
PARSE_ERROR | Failed to parse SearchXNG JSON response |
Runtime notes
- Results are cached for 5 minutes by query+operation key — cached=true when served from cache
- search_url is empty string when results come from cache
- operation maps to SearchXNG categories: search_medical and search_academic use 'science', search_news uses 'news'
- Requires a running SearchXNG instance; defaults to http://localhost:8888 or SEARCHXNG_URL env var
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..