dsh-9router-web-search

🛠️ Configuration

Key	Type	Default	Description
baseURL	string	—	Base URL of your 9router-compatible API (http/https only); resolved as explicit setting → NINE_ROUTER_BASE_URL env → absent (provider unavailable)
searchModel	string	search-combo	Model name for the search endpoint
fetchModel	string	fetch-combo	Model name for the fetch endpoint
searchType	string	web	search_type sent to the search endpoint
defaultMaxResults	number	8	Source cap used only when a search request does not specify maxResults (the DSH seam enforces the per-operation limit)
timeoutMs	number	30000	Shared per-request timeout (per-capability defaults)
searchTimeoutMs	number	30000	Search-only timeout; blank follows timeoutMs
fetchTimeoutMs	number	30000	Fetch-only timeout; blank follows timeoutMs
fetchFormat	string	markdown	Body format requested from the fetch endpoint (markdown, text, html)
maxCharacters	number	50000	Character cap for fetched bodies; sent to the gateway and enforced locally
apiKey	secret	—	Literal API key (optional; no key = no Authorization header)
apiKeyEnv	credential-ref	NINE_ROUTER_API_KEY	Credentials-service key name

Self-hosted 9router picks its search and fetch backends from its own provider configuration and ignores searchModel/fetchModel; keep those fields set for cloud gateways that route by model.

Endpoint precedence — an explicit baseURL setting wins over the NINE_ROUTER_BASE_URL environment value; with neither set, no endpoint exists and the providers report themselves unavailable. There is no silent fallback to a repository-chosen remote. The schema rejects non-http(s) URLs, empty model/format strings, and non-positive numeric limits before any request is made.

Credentials — NINE_ROUTER_API_KEY is resolved through DSH's credentials service; a literal apiKey is optional and wins when set. apiKeyEnv is a reference name in the credentials service, not a key. The secret is write-only in the settings UI, is never stored in git, and never appears in logs, diagnostics, or error messages.