
tavily-search
โ 399by tavily-ai ยท part of tavily-ai/skills
Web search with LLM-optimized results, content snippets, and relevance scores. Supports four search depths (ultra-fast, fast, basic, advanced) with configurable result counts up to 20, plus domain filtering and time-range constraints Returns structured JSON output with content snippets, relevance scores, and metadata optimized for LLM consumption Includes specialized search modes for news and finance topics, with optional AI-generated answers and full page content extraction Integrates into...
Web search with LLM-optimized results, content snippets, and relevance scores. Supports four search depths (ultra-fast, fast, basic, advanced) with configurable result counts up to 20, plus domain filtering and time-range constraints Returns structured JSON output with content snippets, relevance scores, and metadata optimized for LLM consumption Includes specialized search modes for news and finance topics, with optional AI-generated answers and full page content extraction Integrates into...
Inspect the full instructions your agent will receiveExpandCollapse
This is the exact playbook injected into your agent when the skill activates โ shown here so you can audit it before installing. You don't need to read it to use the skill.
by tavily-ai
Web search with LLM-optimized results, content snippets, and relevance scores. Supports four search depths (ultra-fast, fast, basic, advanced) with configurable result counts up to 20, plus domain filtering and time-range constraints Returns structured JSON output with content snippets, relevance scores, and metadata optimized for LLM consumption Includes specialized search modes for news and finance topics, with optional AI-generated answers and full page content extraction Integrates into...
npx skills add https://github.com/tavily-ai/skills --skill tavily-search
Download ZIPGitHub399
tavily search
Web search returning LLM-optimized results with content snippets and relevance scores.
When to use
-
You need to find information on any topic
-
You don't have a specific URL yet
-
First step in the workflow: search โ extract โ map โ crawl โ research
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-contentwhen you need full page text (saves a separate extract call). -
Use
--include-domainsto focus on trusted sources. -
Use
--time-rangefor recent information. -
Read from stdin:
echo "query" | tvly search - --json
See also
-
tavily-extract โ extract content from specific URLs
-
tavily-research โ comprehensive multi-source research
npx skills add https://github.com/tavily-ai/skills --skill tavily-searchRun this in your project โ your agent picks the skill up automatically.
Before running any command
If tvly is not found on PATH, install it first:
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 for alternative install methods and auth options.
Quick start
# 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
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.