tavily-ai/tavily-search
skills/tavily-search/SKILL.md
Search the web with LLM-optimized results via the Tavily CLI. Use this skill when the user wants to search the web, find articles, look up information, get recent news, discover sources, or says "search for", "find me", "look up", "what's the latest on", "find articles about", or needs current information from the internet. Returns relevant results with content snippets, relevance scores, and metadata — optimized for LLM consumption. Supports domain filtering, time ranges, and multiple search depths.
$ install --global
skillsauthnpx skillsauth add tavily-ai/skills tavily-searchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 4, 2026, 11:49 PM15.7s1 file scanned
SKILL.md
- name:
- tavily-search
- description:
- |
- allowed-tools:
- Bash(tvly *)
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:
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.
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
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
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
Related Skills
tavily-ai/tavily-research
tools
VerifiedTrustedCommunity
Conduct comprehensive AI-powered research with citations via the Tavily CLI. Use this skill when the user wants deep research, a detailed report, a comparison, market analysis, literature review, or says "research", "investigate", "analyze in depth", "compare X vs Y", "what does the market look like for", or needs multi-source synthesis with explicit citations. Returns a structured report grounded in web sources. Takes 30-120 seconds. For quick fact-finding, use tavily-search instead.
209SKILL.mdUpdated Apr 15, 2026
tavily-ai/tavily-map
tools
VerifiedTrustedCommunity
Discover and list all URLs on a website without extracting content, via the Tavily CLI. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where something is on a domain, or says "map the site", "find the URL for", "what pages are on", "list all pages", or "site structure". Faster than crawling — returns URLs only. Essential when you know the site but not the exact page. Combine with extract for targeted content retrieval.
209SKILL.mdUpdated Apr 15, 2026
tavily-ai/tavily-extract
tools
VerifiedTrustedCommunity
Extract clean markdown or text content from specific URLs via the Tavily CLI. Use this skill when the user has one or more URLs and wants their content, says "extract", "grab the content from", "pull the text from", "get the page at", "read this webpage", or needs clean text from web pages. Handles JavaScript-rendered pages, returns LLM-optimized markdown, and supports query-focused chunking for targeted extraction. Can process up to 20 URLs in a single call.
209SKILL.mdUpdated Apr 15, 2026
tavily-ai/tavily-dynamic-search
development
VerifiedTrustedCommunity
Programmatic web search with context isolation. Use this skill for any research task where you need to search the web, filter results, and extract specific information — without polluting your context window with raw HTML and boilerplate. This is the default skill for web research. Triggered by "search for", "look up", "find", "research", "what's the latest on", or any query that requires current web information. Also use when asked to "search and filter", "find the important parts", or "extract the key details" — any case where the user wants curated, noise-free content.
209SKILL.mdUpdated Apr 15, 2026