Search & Researchdsh-plugin

dsh-search-failover

DSH provider-level web search and fetch failover pool supporting Exa, Serper, Tavily, Jina, Firecrawl, SerpApi, SearXNG, DuckDuckGo, Brave, and optional opencodex. It provides failover and weighted routing, quota-aware circuit breaking, multi-key rotation, and keeps native web_search/web_fetch signatures.

Stars
4
Forks
0
Open issues
1
Last push
Oct 21, 2026
Latest release
v0.3.22
24h Growth
+0
7d Growth
+0

Installation

dsh plugin --profile web add dsh-search-failover

Overview

DSH provider-level web search and fetch failover pool supporting Exa, Serper, Tavily, Jina, Firecrawl, SerpApi, SearXNG, DuckDuckGo, Brave, and optional opencodex. It provides failover and weighted routing, quota-aware circuit breaking, multi-key rotation, and keeps native web_search/web_fetch signatures.

  • Transparently takes over DSH ctx.web search and fetch while keeping native web_search and web_fetch tool signatures unchanged.
  • Supports failover by priority and weighted rotate across configured backends.
  • Quota-aware circuit breaker uses a 1-hour cooldown on quota exhaustion and a 60-second cooldown after repeated transient failures.
  • Automatically switches to the next backend or API key when a backend fails or its quota is exhausted.
  • Registers web_search_from so an agent can explicitly query a chosen backend such as exa, serper, tavily, jina, firecrawl, or searxng.
  • Web GUI settings panel supports API key entry, strategy switching, priority ordering, connectivity tests, and weight adjustment.
  • Supports multiple keys per backend entered on separate lines or separated by commas.
  • Web fetch takeover uses Jina Reader, Exa Contents, Tavily Extract, or Firecrawl Scrape.

Related plugins