README
@tonydua/dsh-web-search-exa
English | 简体中文
Adds Exa web search to DeepSeek Harness (dsh), the anonymous no-key variant.
dsh plugin --profile web add @tonydua/dsh-web-search-exa
Restart dsh web and it works. No API key, no config edits, no provider to select.
Background, for reference only:
- Exa is a search API. It retrieves pages by keyword or by meaning and returns citable sources with excerpts. It does not generate answers. Exa offers a REST API and also runs an unauthenticated public MCP server.
- The official
dsh-web-search-exais dsh's Exa search provider. It uses Exa's REST API and is only useful once you configure an API key. - This package is a modified copy of the official one. The REST path works the same. What we added is a keyless channel: with no key it uses Exa's public MCP server, and with a key it still uses REST. The anonymous approach follows the oh-my-pi project, see Acknowledgements.
You can ignore all of this by default. Read Selecting a provider only if you also run the official package, or if dsh reports an ambiguous provider.
Built with deepseek-v4-flash inside DeepSeek Harness (dsh). The 0.2.3 live-config work was done with GLM-5.3-flash.
Features
- Works without a key. Searches go through Exa's public MCP server (
mcp.exa.ai/mcp) and carry no credentials. - Returns structured results on that keyless path. It calls
web_search_advanced_exa, whose output is JSON in the REST field vocabulary, so sources carry real highlight snippets without text parsing. - Upgrades itself when you add a key. Setting
EXA_API_KEYswitches to Exa'sPOST /searchREST API for higher limits, with no behavior change. - Drop-in. It registers into the dsh
ctx.webseam; the model-facingweb_searchandweb_fetchtools, their prompt sections, and the result cards all stay as they are. - Works out of the box. With no official package installed there is no provider to select.
- Backs off when it fails. After repeated failures on the anonymous channel the plugin marks itself unavailable so dsh can pick another provider, instead of failing every search. See What happens when a search fails.
Installation
Pick one of three. The choice only decides where the code comes from; all three end up the same.
From npm. The dsh.bundle manifest ships the bundle patch, so the provider row is inserted for you and you do not edit any patch by hand.
dsh plugin --profile web add @tonydua/dsh-web-search-exa
From the GitHub Release. The same tarball, for when npm is unreachable.
dsh plugin --profile web add https://github.com/TonyDua/dsh-web-search-exa/releases/latest/download/dsh-web-search-exa.tgz
From the repository. Tracks main, including work not yet released.
dsh plugin --profile web add github:TonyDua/dsh-web-search-exa
For a local development checkout, use the same command with a path instead of a package name: dsh plugin --profile web add ../plugins/dsh-web-search-exa.
Restart dsh web afterwards. That is the whole procedure in most cases.
Selecting a provider
Skip this section unless you install the official package too.
Before each search, the dsh seam picks an available provider. If exactly one is available it is selected automatically. If more than one is available the seam raises WEB_PROVIDER_AMBIGUOUS and asks you to name one. So there are only two cases where you have to act:
- You installed the official package as well. Both packages register the provider id
exa, sodsh webfails at startup withWEB_DUPLICATE_PROVIDER. You must give this package a different id first, see Coexistence with the official package. - You see
WEB_PROVIDER_AMBIGUOUS. Another provider is available. Name the one you want.
Two ways to name it:
# $DSH_HOME/profiles/web/cordis.patch.yml
- id: web
name: '@deepseek-ai/dsh-web'
config:
searchProvider: exa
Or set $DSH_WEB_SEARCH_PROVIDER=exa at runtime.
Restart dsh web after the change. The model-facing web_search tool then uses the selected provider; no tool configuration changes.
Release artifacts and install warnings (usually not needed)
Release artifacts. CI packs this version's tarball, verifies it against every supported dsh version, attaches it to the GitHub Release, and publishes that same artifact to npm. So the release asset and the npm tarball are one file, not two builds that happen to match.
更多「网页与浏览器」插件
anysearch-dsh
作者 anysearch-team
为 DeepSeek Harness 提供的 AnySearch 网页搜索提供方与高级搜索工具。
dsh-find-plugin
作者 awesome-dsh-plugin
Find DSH plugins inside the agent — live GitHub dsh-plugin topic search, star-ranked / 会话内搜索发现 DSH 插件
fnos-dsh
作者 fnosp
DeepSeek Harness应用与harness插件 monorepo
modsearch
作者 liustack
🥇 The strongest free web search plugin for DeepSeek Harness, and the search bridge for every model without native web access. Free, no signup, no API key. Ask the web or X, get structured JSON evidence. | 🥇 全网最强的 DeepSeek Harness 免费联网搜索插件,免费免注册免 API key。为不能联网的模型补上搜索,问网页或 X,拿回结构化 JSON 证据(搜索、抓取、引用)。
