dsh-web-search-provider
In a curated listMaintenance: Activehiyms/dsh-web-search-provider
Improve web search in Deepseek Harness, use server-side search service.
$ dsh plugin add dsh-web-search-providerInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work5
stars
1
forks
TypeScript
Language
MIT
License
2026-08-14
Created
2026-09-01
Last push
README
dsh-web-search-provider
Network search support for the Deepseek Harness, powered by the model provider's server-side capability.
Using this plugin requires the model provider to use the OpenAI Responses API or an Anthropic-compatible Messages API, and to provide a web search capability.
[!TIP] The Anthropic-compatible Messages API only provides a search capability, while the OpenAI Responses API additionally supports viewing a URL's page content / finding specific content within a URL's page. Providers on the OpenAI Responses API are recommended.
[!TIP] Verified to work with: the Deepseek official Messages API (the DSH built-in Deepseek provider), the OpenCode Go Messages API, the OpenCode Go Response API, and an OpenAI relay station's Response API.
[!WARNING] The DSH built-in OpenCode Go provider uses different API types for different models. For example, for its Deepseek V4 Flash/Pro models, to use this plugin's capability you need to manually add a custom provider of the Response / Message API type.
[!WARNING] Some model providers may charge extra for the web search capability this plugin uses.
This plugin does not provide its support through the web_search tool inside the Deepseek Harness, so you can use it alongside other web search provider plugins (such as the built-in web-search-deepseek).
Comparing with web-search-deepseek
TL;DR Compared with
web-search-deepseek, this plugin has a clear advantage in both token consumption and time.
web-search-deepseek is the Deepseek Harness's built-in search plugin: when the model in a session calls the web_search tool, it creates a new internal session to run the search and returns several URLs with their content summaries.
Compared with web-search-deepseek, the AI in this plugin's sessions sends the network search request directly to the server, making each individual search faster. Also, the model can directly view / search page content (only with the OpenAI Responses API), reducing the tokens the AI spends on bash/curl to read a page's full content.
Using the Deepseek official Messages API's deepseek-v4-flash model with high think, each plugin performed 5 specified searches per run, tested 10 times:
| Plugin | Average tokens | Average time |
|---|---|---|
| web-search-deepseek | 4,446 | 47.5s |
| web-search-provider | 822 | 14.5s |
Time is measured from the answer duration shown in the Deepseek Harness. Tokens are the average of the "output" tokens reported on the Deepseek Open Platform, using two different API tokens (because the Deepseek Harness does not count tokens consumed inside tool calls).
The results are for reference only. On tasks that need more web search content, this plugin is expected to show a more pronounced advantage.
Install
dsh plugin add dsh-web-search-provider
Or install from source:
pnpm install
Reference the built plugin from a cordis.yml overlay:
- insert:
- id: web-search-provider
name: 'dsh-web-search-provider'
config:
enabled: true
probe: true
Config
Settings section web-search-provider (a live namespace: edits reach the next request). All fields are optional unless noted.
| Key | Default | Meaning |
|---|---|---|
enabled |
true |
Master switch; false sends every request down the normal adapter path. |
providers |
[] |
Provider whitelist (llm-pi-ai route keys). A request is served only when its provider is also the current chat route (the plan derives its endpoint facts from that route); the whitelist restricts which of its providers may be served. Empty = serve the current chat route. |
baseURL |
route | Endpoint base override for the route's candidates; /responses or /messages is appended. |
model |
loop model | Model override; used by the capability probe and by the served wire request. |
apiKeyEnv |
route ref | Credential reference resolved per operation. |
includeSources |
true |
Append include: ['web_search_call.action.sources'] to Responses wire requests. |
stripServerTools |
true |
Strip the function-tool variants (web_search/open_page/find_in_page) from the wire tools. |
idleTimeoutMs |
300000 |
Idle bound for one inline request, in milliseconds. |
probe |
true |
Verify the endpoint executes native search before serving. |
probeTimeoutMs |
30000 |
Bound on one probe request, in milliseconds. |
- id: web-search-provider
name: 'dsh-web-search-provider'
config:
enabled: true
probe: true
Known limitations
- For providers that use the Response API / Message API but do not provide a search capability, the session errors on first use. Keep sending messages / open a new session and DSH keeps working without this plugin's capability.
- When the AI uses this plugin's web search capability, there is no visible search-call UI. The usage may appear as multiple consecutive thinking segments, with the tail of a thinking segment containing something like "Let me make search queries".
Contributing
Building
pnpm install
pnpm build # tsc emits lib/types, tsdown bundles lib/index.js
pnpm test # vitest unit suite
More in Web & Browser
anysearch-dsh
by anysearch-team
AnySearch web search provider and advanced search tools for DeepSeek Harness (DSH)
dsh-find-plugin
by awesome-dsh-plugin
In-agent plugin discovery: live GitHub repository search scoped to the official `dsh-plugin` topic, star-ranked; every result comes with a ready-to-run `dsh plugin add` command.
fnos-dsh
by fnosp
Multi-source web search and fetch failover for DeepSeek Harness sessions: takes over the session searchProvider and fetchProvider seams and tries configured sources in a chosen order — TinyFish, Tavily and the official search as a fallback that always participates and can be repositioned but not removed. Multiple API keys per platform are spread round-robin, usage snapshots drive pre-flight exclusion of exhausted accounts, and per-request timeouts plus same-platform retry control failover granularity. Web fetching runs local HTTP first, then falls back to TinyFish Fetch server-side rendering and Tavily Extract, so pages still load when local egress is blocked by proxy or DNS policies. A per-platform panel shows key usage and plan limits. Install from npm with `dsh plugin --profile web add @tnnevol/dsh-failover-search`.
modsearch
by liustack
Web/X 搜索与抓取桥:为纯文本 coding agent 提供结构化 JSON 证据(search/fetch/citations),引擎可选 Antigravity CLI(免 key)/带 key 引擎/X(Grok Build 登录态)。
