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.
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.