Tavily AI search platform with 5 modes: Search (web/news/finance), Extract (URL content), Crawl (website crawling), Map (sitemap discovery), and Research (deep research with citations). Use for: web s
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
AI-powered web search platform with 5 modes: Search, Extract, Crawl, Map, and Research.
TAVILY_API_KEY| Env Variable | Default | Description |
|---|---|---|
| โ | Required. Tavily API key |
Set in OpenClaw config:
{ "env": { "TAVILY_API_KEY": "tvly-..." } }
python3 skills/tavily/lib/tavily_search.py <command> "query" [options]
General-purpose web search with optional LLM-synthesized answer.
python3 lib/tavily_search.py search "query" [options]
Examples:
# Basic search python3 lib/tavily_search.py search "latest AI news"With LLM answer
python3 lib/tavily_search.py search "what is quantum computing" --answer
Advanced depth (better results, 2 credits)
python3 lib/tavily_search.py search "climate change solutions" --depth advanced
Time-filtered
python3 lib/tavily_search.py search "OpenAI announcements" --time week
Domain filtering
python3 lib/tavily_search.py search "machine learning" --include-domains arxiv.org,nature.com
Country boost
python3 lib/tavily_search.py search "tech startups" --country US
With raw content and images
python3 lib/tavily_search.py search "solar energy" --raw --images -n 10
JSON output
python3 lib/tavily_search.py search "bitcoin price" --json
Output format (text):
Answer: <LLM-synthesized answer if --answer>Results:
Result Title https://example.com/article Content snippet from the page...
Another Result https://example.com/other Another snippet...
Search optimized for news articles. Sets
topic=newspython3 lib/tavily_search.py news "query" [options]
Examples:
python3 lib/tavily_search.py news "AI regulation" python3 lib/tavily_search.py news "Israel tech" --time day --answer python3 lib/tavily_search.py news "stock market" --time week -n 10
Search optimized for financial data and news. Sets
topic=financepython3 lib/tavily_search.py finance "query" [options]
Examples:
python3 lib/tavily_search.py finance "NVIDIA stock analysis" python3 lib/tavily_search.py finance "cryptocurrency market trends" --time month python3 lib/tavily_search.py finance "S&P 500 forecast 2026" --answer
Extract readable content from one or more URLs.
python3 lib/tavily_search.py extract URL [URL...] [options]
Parameters:
urls--depth basic|advanced--format markdown|text--query "text"Examples:
# Extract single URL python3 lib/tavily_search.py extract "https://example.com/article"Extract multiple URLs
python3 lib/tavily_search.py extract "https://url1.com" "https://url2.com"
Advanced extraction with relevance reranking
python3 lib/tavily_search.py extract "https://arxiv.org/paper" --depth advanced --query "transformer architecture"
Text format output
python3 lib/tavily_search.py extract "https://example.com" --format text
Output format:
URL: https://example.com/article โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ <Extracted content in markdown/text>URL: https://another.com/page โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ <Extracted content>
Crawl a website starting from a root URL, following links.
python3 lib/tavily_search.py crawl URL [options]
Parameters:
url--depth basic|advanced--max-depth N--max-breadth N--limit N--instructions "text"--select-paths p1,p2--exclude-paths p1,p2--format markdown|textExamples:
# Basic crawl python3 lib/tavily_search.py crawl "https://docs.example.com"Focused crawl with instructions
python3 lib/tavily_search.py crawl "https://docs.python.org" --instructions "Find all asyncio documentation" --limit 20
Crawl specific paths only
python3 lib/tavily_search.py crawl "https://example.com" --select-paths "/blog,/docs" --max-depth 3
Output format:
Crawled 5 pages from https://docs.example.comPage 1: https://docs.example.com/intro โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ <Content>
Page 2: https://docs.example.com/guide โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ <Content>
Discover all URLs on a website (sitemap).
python3 lib/tavily_search.py map URL [options]
Parameters:
url--max-depth N--max-breadth N--limit NExamples:
# Map a site python3 lib/tavily_search.py map "https://example.com"Deep map
python3 lib/tavily_search.py map "https://docs.python.org" --max-depth 3 --limit 100
Output format:
Sitemap for https://example.com (42 URLs found):
Comprehensive AI-powered research on a topic with citations.
python3 lib/tavily_search.py research "query" [options]
Parameters:
query--model mini|pro|autominiproauto--jsonExamples:
# Basic research python3 lib/tavily_search.py research "Impact of AI on healthcare in 2026"Pro model for thorough research
python3 lib/tavily_search.py research "Comparison of quantum computing approaches" --model pro
JSON output
python3 lib/tavily_search.py research "Electric vehicle market analysis" --json
Output format:
Research: Impact of AI on healthcare in 2026<Comprehensive research report with citations>
Sources: [1] https://source1.com [2] https://source2.com ...
| Option | Applies To | Description | Default |
|---|---|---|---|
| search, news, finance, extract | Search/extraction depth | basic |
| search, news, finance | Time range filter | none |
| search, news, finance | Max results (0-20) | 5 |
| search, news, finance | Include LLM answer | off |
| search, news, finance | Include raw page content | off |
| search, news, finance | Include image URLs | off |
| search, news, finance | Only these domains | none |
| search, news, finance | Exclude these domains | none |
| search, news, finance | Boost country results | none |
| all | Structured JSON output | off |
| extract, crawl | Content format | markdown |
| extract | Relevance reranking query | none |
| research | Research model | auto |
| crawl, map | Max link depth | 2 |
| crawl, map | Max pages per level | 10/20 |
| crawl, map | Max total pages/URLs | 10/50 |
| crawl | Natural language instructions | none |
| crawl | Include path patterns | none |
| crawl | Exclude path patterns | none |
| API | Basic | Advanced |
|---|---|---|
| Search | 1 credit | 2 credits |
| Extract | 1 credit/URL | 2 credits/URL |
| Crawl | 1 credit/page | 2 credits/page |
| Map | 1 credit | 1 credit |
| Research | Varies by model | - |
bash skills/tavily/install.sh
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
ยฉ 2026 Torly.ai. All rights reserved.