Skip to main content

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​

NameTypeRequiredDescription
querytextNoSearch query string (overrides config)

Output ports​

NameTypeRequiredDescription
resultsjsonNoArray of search results with title, url, content, engine, and score
totalnumberNoNumber of results returned
querytextNoSearch query used
cachedbooleanNoWhether the results came from cache
search_urltextNoFull SearchXNG URL used

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
QueryquerystringNoDefault search query (used if no query input)
OperationoperationenumNosearchsearch, search_medical, search_academic, search_newsSearch category/operation
Max Resultsmax_resultsnumberNo10min 0Maximum number of results to return
LanguagelanguagestringNoenSearch language code
Safe SearchsafesearchnumberNo1min 0; max 2Safe search level (0=off, 1=moderate, 2=strict)

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
EnginesenginesstringNoComma-separated list of search engines to use
Timeout (seconds)timeoutnumberNo10min 1Search request timeout in seconds
SearchXNG URLsearchxng_urlstringNohttp://localhost:8888Base URL of the SearchXNG instance

Errors​

CodeDescription
QUERY_REQUIREDNo search query provided via input or config
SEARCHXNG_UNREACHABLECannot connect to the SearchXNG instance
HTTP_ERRORSearchXNG returned a non-2xx HTTP status
PARSE_ERRORFailed 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.

Something unclear? Send documentation feedback by email.