Aller au contenu principal

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.

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.