tavily-web-search

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# Tavily Web Search Plugin for DeepSeek Harness

Provides web search capability to DSH via [Tavily API](https://tavily.com) — both as a **WebSearchProvider** (for `ctx.web`) and a **model-facing tool** (`tavily_search`).

## What You Get

### 1. `tavily_search` tool
Full control over every Tavily search parameter. Call it like any other tool:

```typescript
await ctx.tools.call('tavily_search', {
  queries: ['your search query'],           // required (uses first)
  searchDepth: 'advanced',                  // 'basic' | 'advanced'
  topic: 'news',                            // 'general' | 'news' | 'finance'
  days: 7,                                  // lookback
  maxResults: 10,                           // 1–50
  includeImages: true,                      // image results as markdown
  includeAnswer: true,                      // generated answer
  includeRawContent: 'markdown',            // raw page content
  includeFavicon: true,                     // favicon URLs in results
  includeDomains: ['example.com'],          // domain filter
  excludeDomains: ['spam.com'],             // domain exclusion
  country: 'united states',                 // geo filter
  startDate: '2024-01-01',                  // ISO 8601
  endDate: '2024-12-31',
  includeUsage: true,                       // credits used
});
```

Returns the raw Tavily response with answer, results, images, and usage info.

### 2. WebSearchProvider (`tavily`)
Standard `WebSearchProvider` for `ctx.web.search()`. Auto-selects when it's the only configured provider. Used by the `web_search` tool from `dsh-tool-web`.

> Note: `web_fetch` uses a separate `WebFetchProvider` interface (not implemented here).

## Setup

### 1. Install in your DSH profile (local development)

```bash
# Clone & build
git clone
cd tavily-web-search && pnpm install && pnpm run build

# Link into your profile
cd ~/.dsh/profiles/your-profile
pnpm add file:/path/to/tavily-web-search
```

### 2. Add to `cordis.patch.yml`

```yaml
- id: tool-web
  disabled: false

- id: tavily-web-search
  name: '@deepseek-ai/tavily-web-search'
  config:
    apiKeyEnv: TAVILY_API_KEY
    maxResults: 10

# Make tavily the active search provider
- id: web
  config:
    searchProvider: tavily
```

### 3. Provide the API key (one of)

**A. DSH Credentials (recommended — encrypted, multi-tenant)**
```bash
# Edit the credentials file directly:
# ~/.dsh/.credentials.yaml

version: 1
refs:
  TAVILY_API_KEY: tvly-xxxxxxxx
```

**B. Environment variable (dev/CI only)**
```bash
export TAVILY_API_KEY=tvly-xxxxxxxx
```

**C. Literal in config (not recommended — visible in plaintext)**
```yaml
config:
  apiKey: "tvly-xxxxxxxx"
```

> **Resolution order:** literal `apiKey` → Credentials (`apiKeyEnv` ref) → `process.env[apiKeyEnv]`.
> Only the first match wins. Credentials file is preferred for production.

### 4. Restart DSH

```bash
pnpm run dev  # or whatever starts your DSH profile
```

## That's it.

Search queries go through `tavily_search` tool calls with full Tavily parameter support. `ctx.web.search()` works automatically when registered.