dsh-web-search-tavily

August 20, 2026 · View on GitHub

😂 还在为 dsh 在“梁文峰”而不是“梁文谷时间”默认调用 DeepSeek 搜索发愁吗？来薅羊毛吧！来把 web_search 换成 Tavily，白嫖实时搜索～

A pluggable Tavily-backed web search provider for DeepSeek Harness (DSH).

Effect — has the DSH model-facing web_search tool return live results from Tavily (api.tavily.com) instead of the bundled DeepSeek search provider. No code changes to the harness; just register one row and pin one config value.

Features

Searches through Tavily (https://api.tavily.com/search).
Returns Tavily's generated answer and per-result sources.
Configurable: search depth, answer on/off, max results, base URL.
Live-editable through a settings namespace — no restart needed to tweak.
Registers on DSH's ctx.web seam, so it works like any other DSH plugin.

Requirements

A running DSH host (the seam packages ship with dsh-base).
A Tavily API key.
An SSH / HTTPS remote is not required — install it into a DSH profile.

Quick start

1. Add the dependency

In your profile directory (e.g. ~/.dsh/profiles/web):

pnpm add file:../path/to/dsh-web-search-tavily

2. Set your key

export TAVILY_API_KEY='tvly-...'

Or store it through DSH's credentials service, and reference it by name.

3. Register the provider

In the profile's composition layer (cordis.patch.yml), add the provider and point DSH's web service at it:

- insert:
    - id: web-search-tavily
      name: 'dsh-web-search-tavily'
      config:
        apiKeyEnv: TAVILY_API_KEY
        includeAnswer: true
        searchDepth: basic

- id: web
  name: '@deepseek-ai/dsh-web'
  config:
    searchProvider: tavily

Restart the DSH host once. From then on web_search uses Tavily.

Configuration

Field	Default	Notes
`apiKey`	–	Literal key; prefer `apiKeyEnv`.
`apiKeyEnv`	`TAVILY_API_KEY`	Env/credential name holding the key.
`baseURL`	`https://api.tavily.com`	Tavily REST base; `/search` appended.
`searchDepth`	`basic`	`basic` or `advanced`.
`includeAnswer`	`true`	Request Tavily's generated answer.
`maxResults`	`5`	Results requested (harness still caps).

All fields can be edited live via the web-search-tavily settings namespace.

Security

The key is read from your environment / credentials service at search time and is never logged or written into the composition file when you use apiKeyEnv.
This is a user-authored plugin. It is not part of any DSH release bundle.

License

MIT