dsh-tavily

DSH's web_search tool calls a built-in search provider by default. It is free but capped by a monthly quota, and swapping in your own Tavily API key has required manual workarounds. dsh-tavily registers a custom search provider through DSH's public registration API so every search call is routed to the Tavily Search API with a single toggle; flipping the toggle back instantly falls through to the official provider without a restart.

The core value is multi-key management. Add any number of Tavily keys and the plugin automatically sorts by remaining credits, spending the ones with the most quota first and round-robining tied keys. If a key hits an authentication error, runs out of credits, or triggers a rate limit, the plugin fails over to the next key and applies a cooldown (5 minutes for auth/over-quota, 30 seconds for 429). Per-key usage is tracked locally: call counts, success/failure splits, credit consumption, last error, and latency. You can also refresh real balances straight from Tavily's official usage endpoint with one click. The settings card exposes search depth, result limit, category, and AI answer options.

Built for DSH power users who exceed the free search quota, manage multiple Tavily accounts, or want a unified view of key-level consumption. Zero dependencies, pure JavaScript, no build step. Install, restart DSH, and you are done.