Features

• Tavily, Exa, Firecrawl, Parallel, Brave, You.com, Jina, SearXNG
• Configurable provider order and fallback
• Multiple API keys per provider
• Quota, key health, and connection test
• Native web_search / web_fetch
• Per-session "Web Search" toggle
• System proxy and self-hosted SearXNG

The plugin does not provide shared API keys or a proxy service. Requests go directly from the local DSH Host to each provider.

Installation

dsh plugin --profile web add github:A3Boy/dsh-web-tools

Restart dsh web, then open:

Settings → Web Search

Update:

dsh plugin --profile web update dsh-web-tools

Remove:

dsh plugin --profile web remove dsh-web-tools

For contributors: this repo has no prepare script. After changing src/, run npm run build manually and commit the compiled lib/ together with your change (otherwise installs fetch stale artifacts). CI also runs npm run build to enforce consistency.

Currently developed and tested against DeepSeek Harness 0.1.0-rc.6.

Providers

A simple starting point:

You do not need to configure every provider.

One provider is enough to use the plugin. Multiple providers enable fallback.

Free tier reference

Some free tiers require account registration or a payment method. Check the upstream provider rules.

Parallel and You.com also offer separate free MCP Search endpoints. The providers in this plugin currently use their REST APIs and therefore still use API keys.

Provider order

Set the order in which providers are used:

Tavily → Firecrawl → Exa → Parallel → Brave

The first provider is the default.

Providers in the search chain can be reordered by dragging.

Removing a provider from the chain does not delete its configuration, so it can still be tested manually.

Fallback

The plugin tries the next provider when the current one has problems such as:

rate limit
timeout
network error
service error
quota exhausted

Example:

Tavily
   ↓ timeout
Firecrawl
   ↓
success

If an API key fails authentication and the provider has multiple keys, another available key is tried first.

Multiple API keys

Each provider can have multiple API keys:

Tavily
├── Key A
├── Key B
└── Key C

The plugin automatically selects an available key.

Keys can be separated by:

newlines
commas
spaces
semicolons

Full API keys are never returned to the browser. The Settings page only receives masked credential information.

Quota

Current quota support:

For supported providers, quota from multiple API keys is combined.

Example:

Key A: 950 / 1000
Key B: 982 / 1000

Pool: 1932 / 2000

Quota is refreshed in the background with a default 5-minute cache.

Brave quota is read from the X-RateLimit-* information returned by Search and the latest result is saved.

Quota information is only used for display and does not block Search.

Test Search

The Settings page can run a real search through the configured provider chain.

It shows:

• final provider
• total latency
• result count
• provider attempts
• success / timeout / rate limit / authentication failure
• search results

Test Search uses the same provider chain as normal agent searches.

Web Fetch

Providers with page-content support:

Tavily
Exa
Firecrawl
Parallel
Jina

A normal flow can be:

web_search
    ↓
URL
    ↓
web_fetch
    ↓
page content

Search and Fetch do not have to use the same provider.

For example:

Brave Search
    ↓
Parallel Fetch

Proxy

Supports:

HTTPS_PROXY
HTTP_PROXY
Windows system proxy

Local addresses bypass the proxy by default:

localhost
127.0.0.1
::1
*.local

NO_PROXY is also supported.

SearXNG

SearXNG does not require an API key.

Configure only the instance URL:

http://127.0.0.1:8080

It can be used alone:

SearXNG

or as part of the fallback chain:

Tavily → Exa → Brave → SearXNG

UI language

The Web Search page supports:

Follow system
中文
English

The language setting only affects this plugin page.

Per-session "Web Search" toggle

A small "Web Search" toggle sits at the left end of the input row. Click it to turn it on or off; once on, it stays on until you click again.

• off — lets the AI decide on its own whether a question needs a web search
• on — runs at least one web search before answering each turn; when a search can't complete, the agent is asked to say which parts were not web-verified
• the state follows the current conversation: refreshing the page or switching conversations doesn't lose it
• the button grays out when there is no usable search source (the plugin is disabled, or no search source is available)
• you can also use /search to toggle the same switch

It works with the 8 search sources: when on, the search automatically falls back through the sources in the order you've configured.

Security

• API keys are used only on the DSH Host
• full API keys are never returned to the browser
• logs do not contain full API keys
• requests do not pass through a server operated by this project
• no search usage telemetry is uploaded
• SearXNG can be used as a fully self-hosted search option

Development

Install:

npm install

Test:

npm test

Type-check:

npx tsc -p tsconfig.json --noEmit
npx tsc -p tsconfig.client.json --noEmit

Build:

npm run build

After changing src/, run npm run build and commit the resulting lib/ too. The package has no prepare script, so GitHub installs use the committed lib/ directly — keep it in sync with src/.

Provider adapters are in:

src/host/providers/

See CONTRIBUTING.md for more information.

Update still showing old code?

If the plugin still behaves like an older version after updating and restarting:

cd ~/.dsh/profiles/web
pnpm install

For local development, file: may use a copied snapshot.

Using link: is usually more convenient.

Contributing

Issues and pull requests are welcome.

New Search Provider suggestions are welcome too.

License

MIT © A3Boy