dsh-web-search-searxng

A standalone SearXNG-backed web search provider for the DeepSeek Harness web profile. It plugs into the harness's web-search seam (ctx.web), so the agent's web_search tool searches through your own self-hosted SearXNG instance instead of a vendor API.

• Plain ESM, no build step.
• Ships as a bundle: one dsh plugin command installs and activates it automatically.
• Single configuration knob: $SEARXNG_BASE_URL.
• Tested (pnpm test, 20 tests, vitest).

The one-command install

From a fresh DeepSeek Harness checkout (or with dsh on PATH):

dsh plugin --profile web add /path/to/dsh-web-search-searxng

That's it. The plugin is automatically appended to the web profile's bundle stack and its patch layer (shipped in this repo as cordis.patch.yml):

• switches the web seam to this provider (searchProvider: searxng), and
• mounts the plugin row.

No cordis.patch.yml hand-editing. No rebuild.

Configure: set one environment variable

Your SearXNG address is read from SEARXNG_BASE_URL (defaults to http://localhost:8888):

export SEARXNG_BASE_URL=http://192.168.30.74:8888   # your instance

Optional knobs:

Variable	Default	Meaning
SEARXNG_BASE_URL	http://localhost:8888	Your SearXNG instance; /search is appended.
SEARXNG_NUM_RESULTS	10	Default result count when a request doesn't specify its own bound.
SEARXNG_API_KEY	(none)	Optional, for instances behind a key.

Then start (or restart) dsh web in that shell — or add the exports to your shell profile / the .env the harness loads.

No environment variables? Then edit the one line in the bundle's :