dsh-web-polysearch

English · 中文

Multi-source web search tool for DeepSeek Harness (DSH).

Queries several search backends in parallel — DeepSeek, DuckDuckGo, Exa, Google, Bing — merges and deduplicates results, and returns a structured answer. Also fetches the full content of a single URL on demand.

Part of the DSH plugin ecosystem. Discovered via the dsh-plugin GitHub topic.

Features

• Parallel multi-engine search — all enabled backends are queried at once via Promise.allSettled; results are merged and deduplicated by URL
• Five built-in backends:
  • DeepSeek — uses the DSH built-in web service (no key)
  • DuckDuckGo — scrapes html.duckduckgo.com (no key)
  • Exa — connects directly to the keyless MCP endpoint at https://mcp.exa.ai/mcp (no key)
  • Google Custom Search — requires API Key + Search Engine ID
  • Bing Web Search — requires Azure API Key
• Direct page fetch — pass url instead of query to fetch a single page's full content
• Optional content fetching — when fetchContent is on, the top results' body text is fetched in parallel
• Bilingual settings UI — Chinese and English, registered with the DSH locale service
• SSE parsing — handles MCP responses in plain JSON and SSE-framed formats

Installation

The plugin is distributed via GitHub. There is no npm release at the moment.

From GitHub (recommended)

dsh plugin --profile web add github:zeroUsr0721/dsh-web-polysearch

dsh plugin forwards the spec to pnpm, which downloads a tarball from GitHub and installs it into the profile. Built artifacts (lib/index.js, lib/client.js) are committed to this repository, so no prepare build step runs at install time and no pnpm-workspace.yaml allow-list is required.

From a local checkout (development)

git clone https://github.com/zeroUsr0721/dsh-web-polysearch.git
dsh plugin --profile web add ./dsh-web-polysearch

pnpm links the checkout via link:, so edits in the source tree take effect after a restart.

Manual edit

Add to your profile's package.json:

{
  "dependencies": {
    "dsh-web-polysearch": "github:zeroUsr0721/dsh-web-polysearch"
  }
}

Then run pnpm install in the profile directory. Add "dsh-web-polysearch" to dsh.profile.bundles if it is not picked up automatically.

Via dshmarket

Once the plugin is admitted to the awesome-dsh-plugin curated registry, it will appear in Settings → Plugins → Plugin Market in the DSH Web GUI for one-click install.

Configuration

Open Settings → Plugins → Web Search Settings in the DSH Web GUI.

Setting	Description	Default
sources	Enabled backends (order matters for merge priority)	All five
maxResults	Max results returned per call	8
fetchContent	Whether to fetch body text for top results	false
fetchCount	How many top results to fetch body for (1–5)	3
googleApiKey	Google Custom Search API Key	—
googleCx	Google Custom Search Engine ID	—
bingApiKey	Bing Web Search API Key	—

Tool: dsh-web-polysearch

Parameters

Parameter	Type	Required	Description
query	string	one of query / url	Search keywords
url	string	one of query / url	URL whose body to fetch directly
maxResults	integer	no	Max results (default: settings value)
fetchContent	boolean	no	Fetch body text for top results (default: settings value)

The tool always uses the backends configured in the settings page — the model cannot override the source list at call time.

Output

{
  "summary": "Found 5 results (sources: exa, duckduckgo).",
  "sources": [
    { "url": "https://...", "title": "...", "snippet": "...", "source": "exa" }
  ],
  "sourceErrors": [
    { "source": "duckduckgo", "error": "fetch failed" }
  ],
  "searchedSources": ["exa", "duckduckgo"]
}

Examples

Search across all configured backends:

{ "query": "DeepSeek Harness plugins", "maxResults": 10 }

Fetch a specific page's content directly:

{ "url": "https://github.com/topics/dsh-plugin" }

Architecture

• Host side (src/index.ts) — registers the dsh-web-polysearch tool, implements each search backend, parses MCP/SSE responses, fetches page content
• Client side (src/client/index.ts) — the Web Search Settings UI: collapsible cards, toggle switches, secret inputs, i18n

The two halves ship as separate bundles (lib/index.js + lib/client.js) and are loaded by the DSH host and browser shell respectively.

Building from source

pnpm install
pnpm run build

Build output: lib/index.js (host) + lib/client.js (client).

Ecosystem

This repository carries the dsh-plugin GitHub topic. Adding the topic to your own plugin repository is the standard way to make a plugin discoverable by:

• The awesome-dsh-plugin directory and its mirror sites
• The community-maintained ecosystem indexes
• Other tooling that consumes the topic as a discovery signal

License

MIT