dsh-web-search-searxng

Configuration

All keys are optional.

Key	Default	Meaning
baseURL	$SEARXNG_URL	Instance root; /search is appended. Missing or non-http(s) makes the provider report unavailable rather than fail every search.
categories	instance default	categories= filter, e.g. ['news'].
engines	instance default	engines= filter, e.g. ['duckduckgo', 'brave'].
language	instance default	language= filter, e.g. ja, en-US.
timeRange	unset	time_range= filter: day / week / month / year.
safesearch	instance default	safesearch=: 0 off, 1 moderate, 2 strict.
timeoutMs	10000	Resource backstop for one search.
maxSnippetChars	500	Per-source snippet cap.
headers	none	Extra request headers, e.g. for an instance behind an authenticating proxy.

- id: web-search-searxng
  name: 'dsh-web-search-searxng'
  config:
    baseURL: http://searxng.internal:8888
    language: ja
    categories:
      - general
      - news

Every search-shaping knob is a deployment setting, not a model argument. The seam's WebSearchRequest is deliberately just query + maxResults; provider-neutral controls (recency, domain filters, search depth) are named deferred work upstream. Keeping them in config is what makes this provider substitutable for the shipped ones.

timeoutMs is a resource backstop, not the model-facing tool-call budget — @deepseek-ai/dsh-tool-call-timeout-policy owns that via tool-web's searchTimeoutMs. Leave this below the tool budget so a slow instance surfaces as a provider failure rather than a tool timeout.