🌐 dsh-web-search-9router

Web search & fetch for DeepSeek Harness, powered by 9router. Wires the native web_search and web_fetch tools into 9router's /v1/search and /v1/web/fetch endpoints — no server-side search tool required.

🇺🇸 English · 🇨🇳 简体中文

---

✨ What it does

• 🔎 Search provider — routes DSH's native web_search through 9router's /v1/search, returning deduplicated WebSource results (title, snippet, published date).
• 📄 Fetch provider — routes DSH's native web_fetch through 9router's /v1/web/fetch, returning clean text/markdown bodies.
• 🎛️ Bundle settings — configure the API key, base URL, models, and limits directly on the plugin's bundle detail page.
• 🔐 Credentials-aware — stores API keys through DSH's credentials service and resolves the configured credential reference (NINE_ROUTER_API_KEY by default).
• 🧱 Zero build — pure ESM, plain JavaScript, no bundler required.

🧭 Why this plugin

DSH's default web_search uses the web-search-deepseek provider, which requires the upstream service to implement Anthropic's web_search_20250305 server-side search tool and return web_search_tool_result blocks.

9router is an OpenAI-compatible gateway: it passes that tool definition to the model as a regular function instead of executing searches server-side — so it cannot provide native search by itself.

	web-search-deepseek (default)	9router (this plugin)
Requires	Anthropic web_search_20250305 server-side tool	Any 9router-compatible gateway
Works with 9router	❌	✅
Search endpoint	model-provided	POST /v1/search
Fetch endpoint	model-provided	POST /v1/web/fetch

This plugin calls 9router's own endpoints directly and maps their responses to the WebSource and WebFetchBody types expected by the DSH web seam.

⚙️ How it works

 web_search / web_fetch (native DSH tools)
            │
            ▼
        ctx.web seam
            │  provider = "9router"
            ▼
  dsh-web-search-9router
   ├── search  → POST {baseURL}/search      → WebSource[]
   └── fetch   → POST {baseURL}/web/fetch   → WebFetchBody
            │
            ▼
      9router gateway (9router)

Errors surface as machine-routable WebError codes (WEB_PROVIDER_ERROR, WEB_PROVIDER_CREDENTIAL_MISSING, WEB_ABORTED), and non-2xx fetch responses come back as results — never silent throws.

🚀 Quick start

Requirements: DSH >=0.2.0-rc.2 and Node.js 20 or later.

1. Install the plugin

npx @deepseek-ai/dsh plugin --profile web add github:rebron1900/dsh-web-search-9router

2. Enable the plugin bundle

Installing and enabling the bundle automatically selects 9router for both search and fetch. Disable the whole bundle in Plugins to restore the providers selected by the remaining configuration layers (normally deepseek-official and http).

If you previously selected providers explicitly in your profile, home configuration, or launch overrides, those higher-priority choices still win. Remove the old id: web provider config override to let bundle enablement control selection.

3. Configure the plugin

Restart DSH and refresh the browser. Open Plugins, select dsh-web-search-9router, and configure it directly on the bundle detail page. Entering an API key stores it in DSH credentials under the selected credential reference; the key is never written to plugin settings.

🔒 Reproducible installs — append a release tag to pin an exact version:

npx @deepseek-ai/dsh plugin --profile web add github:rebron1900/dsh-web-search-9router#v0.2.4

🛠️ Configuration

Key	Type	Default	Description
baseURL	string	9router default endpoint	Base URL of your 9router-compatible API (NINE_ROUTER_BASE_URL env also honored)
searchModel	string	search-combo	Model name for the search endpoint
fetchModel	string	fetch-combo	Model name for the fetch endpoint
searchType	string	web	search_type sent to the search endpoint
maxResults	number	8	Max sources per search
timeoutMs	number	30000	Per-request timeout
API key	credential	—	Write-only field stored by the DSH credentials service, not in plugin settings
apiKeyEnv	credential-ref	NINE_ROUTER_API_KEY	Credential reference used to store and resolve the API key

🧪 Development

pnpm install   # install dependencies
pnpm test      # run the test suite (node:test)

Repository layout

dsh-web-search-9router/
├── src/index.js       # plugin entry: search + fetch providers
├── client.js          # bundle detail settings form
├── cordis.patch.yml   # bundle patch registering the plugin
├── test/              # node --test suite
└── package.json       # ESM plugin manifest

🌱 Ecosystem & releases

• 📦 Distribution — the GitHub repository is the only distribution source; stable versions ship as v<version> GitHub Releases.
• 📚 Directory — listed in awesome-dsh-plugin.
• 🐛 Issues & requests — open an issue.

📄 License

MIT