dsh-web-search-router

A free multi-provider web search router for DeepSeek Harness (DSH).

The plugin keeps DSH's built-in web_search tool and registers a multi-search provider. It starts with the keyless Parallel endpoint, then falls back through configured search APIs only when more results are needed or a provider fails.

Features

• Keyless Parallel search as the first route.
• Optional Tavily, Exa, Brave Search, Serper, and SerpApi fallbacks.
• Dynamic fallback order balancing estimated free capacity and observed latency.
• Early exit as soon as enough unique results have been collected.
• URL canonicalization, deduplication, and reciprocal rank fusion (RRF).
• Provider cooldowns after rate-limit, quota, authentication, or transient errors.
• Write-only API key controls in the DSH Settings page.
• No dependency on the paid DeepSeek web search provider.

Routing

Each request follows this sequence:

1. Query Parallel without an API key.
2. Stop immediately if enough unique results were returned.
3. Rank configured keyed providers by remaining estimated free capacity and exponentially weighted observed latency.
4. Query one provider at a time and stop as soon as the requested result count is reached.
5. Deduplicate and merge all collected results with RRF.

The initial keyed-provider estimates currently favor Tavily, Exa, Brave Search, Serper, and SerpApi according to the capacity/latency score. Runtime measurements can change that order automatically.

Cooldowns are 10 minutes for HTTP 429, 6 hours for quota or credit exhaustion, 1 hour for authentication failures, and 1 minute for other transient failures. These are process-local health hints, not live quota counters.

Installation

From the DSH web profile directory, install the GitHub repository:

cd ~/.dsh/profiles/web
pnpm add github:chenyuhao0628/dsh-web-search-router

Add dsh-web-search-router to dsh.profile.bundles in that profile's package.json, then restart DSH. Select multi-search as the web search provider if it is not already selected.

For local development, a link dependency also works:

{
  "dependencies": {
    "dsh-web-search-router": "link:/absolute/path/to/dsh-web-search-router"
  }
}

API Keys

Open DSH Settings and choose 网络搜索. Each field writes directly to DSH's credential service and never reads the stored secret back into the page.

Provider	Credential reference	Required
Parallel	None	No
Tavily	TAVILY_API_KEY	No
Exa	EXA_API_KEY	No
Brave Search	BRAVE_SEARCH_API_KEY	No
Serper	SERPER_API_KEY	No
SerpApi	SERPAPI_API_KEY	No

API keys are not stored in Cordis configuration or this repository. Do not put credentials in package.json, commits, issue reports, or screenshots.

Development

Requires Node.js 20 or newer and pnpm.

pnpm install
pnpm check
pnpm test

The tests cover URL normalization, RRF merging, and provider ranking. The plugin targets the Cordis and DSH web APIs declared in peerDependencies.

License

MIT