| name | tavily-search |
| description | Search the web with LLM-optimized results via the Tavily CLI. Use this skill whenever a scan needs to find papers, releases, announcements or articles, discover sources on a topic, or check what is new — i.e. whenever there is no specific URL yet. Returns relevant results with content snippets, relevance scores and metadata. Supports domain filtering, time ranges and multiple search depths.
|
| allowed-tools | Bash(tvly *) |
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
tvly search "your query" --json
tvly search "trellis coded quantization LLM" --depth advanced --max-results 10 --json
tvly search "open-weight model release" --time-range week --topic news --json
tvly search "KV cache quantization" --include-domains arxiv.org,github.com --json
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.co biases toward primary sources.- Search snippets are NEVER citable evidence on their own — open the URL with
the
tavily-extract skill first (see radar-source-verify).
