dsh-web-search-router

DSH's built-in web_search tool has always depended on a single paid DeepSeek search API, capping both result coverage and adding a recurring cost. dsh-web-search-router keeps the existing web_search entry point but registers a multi-provider free search route ahead of it: every query first hits the keyless Parallel endpoint, and only when results are insufficient or the endpoint is unavailable does the router fall back to Tavily, Exa, Brave Search, Serper, or SerpApi in a dynamically ordered chain. The result is no hard dependency on any single paid provider.

Under the hood the router continuously estimates each provider's remaining free capacity and observed latency, reordering the fallback list at runtime. Once results are collected it canonicalizes URLs, deduplicates entries, and merges everything with reciprocal rank fusion. Providers that return 429, exhaust their quota, fail authentication, or throw transient errors are placed on automatic cooldowns ranging from one minute to six hours, so the chain does not hammer a dead endpoint. API keys are written through a write-only field in DSH Settings; the page shows live quota metadata, cooldown state, and a refresh button for Tavily and SerpApi balance checks.

The plugin is a practical fit for DSH users who want broader search coverage at zero marginal cost: Parallel works out of the box with no keys at all, and anyone who already holds one or more search API keys gains a resilient fallback ladder. If you are a developer looking to decouple from DeepSeek's paid web search while keeping good result quality and tight credential hygiene, this router gives you both.