tavily search
Web search returning LLM-optimized results with content snippets and relevance scores.
Before running any command
Check tvly --status. If tvly is not on PATH:
pip install -q tavily-cli || uv tool install tavily-cli
Auth comes from the TAVILY_API_KEY environment variable (already set in this
environment). Never print it. If it is unset, report that and fall back to the
built-in web tools.
Quick start
# Basic search
tvly search "your query" --json
# Precision search with more results
tvly search "trellis coded quantization LLM" --depth advanced --max-results 10 --json
# Recent items only
tvly search "open-weight model release" --time-range week --topic news --json
# Primary sources only
tvly search "KV cache quantization" --include-domains arxiv.org,github.com --json
# Full page content inline (saves a separate extract call)
tvly search "vLLM disaggregated serving" --include-raw-content --max-results 3 --json
Key options
| Option | Description |
|---|---|
--depth |
ultra-fast, fast, basic (default), advanced (highest relevance) |
--max-results |
0–20 (default 5) |
--topic |
general (default), news, finance |
--time-range |
day, week, month, year |
--start-date / --end-date |
Bound results by date (YYYY-MM-DD) |
--include-domains / --exclude-domains |
Comma-separated domain filters |
--include-raw-content |
Full page content (markdown or text) |
--chunks-per-source |
Chunks per source (advanced/fast depth) |
--json / -o FILE |
Structured output / save to file |
Tips
- Keep queries under 400 characters; break complex questions into sub-queries.
--include-domains arxiv.org,github.com,huggingface.cobiases toward primary sources.- Search snippets are NEVER citable evidence on their own — open the URL with
the
tavily-extractskill first (seeradar-source-verify).