---
id: gh-tavily-search
name: "tavily-search"
url: https://skills.yangsir.net/skill/gh-tavily-search
author: tavily-ai
domain: ai-llm-engineering
tags: ["web-search", "information-retrieval", "llm-optimization", "rag"]
install_count: 25300
rating: 4.60 (120 reviews)
github: https://github.com/tavily-ai/skills/tree/main/skills/tavily-search
---

# tavily-search

> Tavily Search 提供针对大语言模型（LLM）优化的网络搜索结果，包含精炼的内容片段和相关性评分。它能帮助 AI 智能体快速获取任何主题的最新信息，尤其适用于需要精确事实和全面上下文的 RAG 应用，显著提升信息检索效率和模型响应质量。

**Stats**: 25,300 installs · 4.6/5 (120 reviews)

## Before / After 对比

### 提升大模型信息检索效率

**Before**:

在为大语言模型（LLM）进行复杂查询的信息检索时，传统搜索方式常耗费大量时间筛选不相关内容，导致 RAG 管道效率低下，模型输出质量受损。

**After**:

通过 Tavily Search 优化的搜索结果，AI 智能体能快速获取高度相关的精炼信息，大幅缩短信息检索时间，显著提升 RAG 管道的效率和 LLM 响应的准确性。

| Metric | Before | After | Change |
|---|---|---|---|
| 信息检索时间 | 30分钟 | 5分钟 | -83% |

## Readme

# tavily search

Web search returning LLM-optimized results with content snippets and relevance scores.

## Before running any command

If `tvly` is not found on PATH, install it first:

```bash
curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login
```

Do not skip this step or fall back to other tools.

See [tavily-cli](../tavily-cli/SKILL.md) for alternative install methods and auth options.

## When to use

- You need to find information on any topic
- You don't have a specific URL yet
- First step in the [workflow](../tavily-cli/SKILL.md): **search** → extract → map → crawl → research

## Quick start

```bash
# Basic search
tvly search "your query" --json

# Advanced search with more results
tvly search "quantum computing" --depth advanced --max-results 10 --json

# Recent news
tvly search "AI news" --time-range week --topic news --json

# Domain-filtered
tvly search "SEC filings" --include-domains sec.gov,reuters.com --json

# Include full page content in results
tvly search "react hooks tutorial" --include-raw-content --max-results 3 --json
```

## Options

| Option | Description |
|--------|-------------|
| `--depth` | `ultra-fast`, `fast`, `basic` (default), `advanced` |
| `--max-results` | Max results, 0-20 (default: 5) |
| `--topic` | `general` (default), `news`, `finance` |
| `--time-range` | `day`, `week`, `month`, `year` |
| `--start-date` | Results after date (YYYY-MM-DD) |
| `--end-date` | Results before date (YYYY-MM-DD) |
| `--include-domains` | Comma-separated domains to include |
| `--exclude-domains` | Comma-separated domains to exclude |
| `--country` | Boost results from country |
| `--include-answer` | Include AI answer (`basic` or `advanced`) |
| `--include-raw-content` | Include full page content (`markdown` or `text`) |
| `--include-images` | Include image results |
| `--include-image-descriptions` | Include AI image descriptions |
| `--chunks-per-source` | Chunks per source (advanced/fast depth only) |
| `-o, --output` | Save output to file |
| `--json` | Structured JSON output |

## Search depth

| Depth | Speed | Relevance | Best for |
|-------|-------|-----------|----------|
| `ultra-fast` | Fastest | Lower | Real-time chat, autocomplete |
| `fast` | Fast | Good | Need chunks, latency matters |
| `basic` | Medium | High | General-purpose (default) |
| `advanced` | Slower | Highest | Precision, specific facts |

## Tips

- **Keep queries under 400 characters** — think search query, not prompt.
- **Break complex queries into sub-queries** for better results.
- **Use `--include-raw-content`** when you need full page text (saves a separate extract call).
- **Use `--include-domains`** to focus on trusted sources.
- **Use `--time-range`** for recent information.
- Read from stdin: `echo "query" | tvly search - --json`

## See also

- [tavily-extract](../tavily-extract/SKILL.md) — extract content from specific URLs
- [tavily-research](../tavily-research/SKILL.md) — comprehensive multi-source research


---
*Source: https://skills.yangsir.net/skill/gh-tavily-search*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-tavily-search/markdown*