@pymodel/dsh-tavily

@pymodel/dsh-tavily

Tavily for DeepSeek Harness: adds the Tavily Search API as a web search provider, plus a Tavily MCP bridge for extract / crawl / map tools.

Install

npm (stable, official recommendation):

dsh plugin --profile web add @pymodel/dsh-tavily
dsh web

Or follow GitHub (latest commit on the repo):

dsh plugin --profile web add github:pymodel/dsh-research-plugins#path:packages/dsh-tavily

Settings → Plugins → Plugin settings → Tavily web search: turn the toggle on. The key is optional; leave it blank for keyless search. Test connection at the bottom-left checks that search works now (including keyless).

Pin a commit:

dsh plugin --profile web add github:pymodel/dsh-research-plugins#path:packages/dsh-tavily#<commit>

Remove:

dsh plugin --profile web remove dsh-tavily

dsh.bundle · prebuilt lib/ · git install does not need allowBuilds

Features

• Settings toggle: off = official DeepSeek, on = Tavily — no uninstall to switch back
• No key uses Tavily keyless; a key uses Authorization: Bearer
• Bottom-left connection test: one real Tavily search (max_results: 1); keyless if no key, account quota if a key is saved (1 credit)
• Timeout, abort, official host lock, drop results without a url
• Key and toggle live on the credentials plane, not the settings file
• Tavily MCP bridge: mcp__tavily__extract, mcp__tavily__crawl, mcp__tavily__map tools (requires a key, see below)

Behavior

Web search

Toggle	Key	web_search
Off (default)	—	official DeepSeek
On	empty	Tavily keyless
On	set	Tavily account quota

Provider id: tavily.

MCP tools

The bundled MCP row registers Tavily's extract / crawl / map tools under the tavily namespace. The hosted Tavily MCP server requires a key, so the row is enabled only when TAVILY_API_KEY is present in the launch environment:

export TAVILY_API_KEY=tvly-...

or in a project .env / $DSH_HOME/.env:

TAVILY_API_KEY=tvly-...

The key is interpolated into the endpoint URL at load time and never written to YAML. A key added to .env needs a dsh web restart.

Credentials

Ref	Meaning
TAVILY_API_KEY	Optional (search). Present = account quota; absent = keyless
TAVILY_SEARCH_ENABLED	Present = on; unset = off

The search key and toggle are stored on the credentials plane ($DSH_HOME/.credentials.yaml). The MCP bridge reads TAVILY_API_KEY from the launch environment instead, because MCP rows resolve before credentials are materialized. Do not commit real keys.

Updates

• 0.1.0 First release as @pymodel/dsh-tavily. Web search provider with settings toggle (off = official DeepSeek, on = Tavily) plus a Tavily MCP bridge (extract / crawl / map). English-only localisation.

Author

elkaix · pymodel