Back to directory

dsh-web-search-exa

In a curated listMaintenance: Active

tonydua/dsh-web-search-exa

Zero-config Exa web search provider for DeepSeek Harness (dsh): keyless anonymous MCP fallback (mcp.exa.ai/mcp) + keyed REST path, with a configurable providerId switch.

View on GitHub
$ dsh plugin add dsh-web-search-exa

Install

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 work

13

stars

3

forks

JavaScript

Language

MIT

License

2026-08-14

Created

2026-10-14

Last push

README

@tonydua/dsh-web-search-exa

English | 简体中文

npm version GitHub release npm downloads License dsh Node GitHub stars GitHub issues

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-exa is 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_KEY switches to Exa's POST /search REST API for higher limits, with no behavior change.
  • Drop-in. It registers into the dsh ctx.web seam; the model-facing web_search and web_fetch tools, 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, so dsh web fails at startup with WEB_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.

Read the full README on GitHub →

More in Web & Browser

anysearch-dsh

by anysearch-team

AnySearch web search provider and advanced search tools for DeepSeek Harness (DSH)

CuratedEvaluatedWeb & BrowserTypeScript
70517

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.

CuratedEvaluatedWeb & BrowserJavaScript
23814

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

CuratedEvaluatedWeb & BrowserTypeScript
12012

modsearch

by liustack

Web/X 搜索与抓取桥:为纯文本 coding agent 提供结构化 JSON 证据(search/fetch/citations),引擎可选 Antigravity CLI(免 key)/带 key 引擎/X(Grok Build 登录态)。

CuratedEvaluatedWeb & BrowserTypeScript
1,02643

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.