dsh-web-search-9router

🌐 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.

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

🧪 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