tavily-cli
Web search, content extraction, crawling, and deep research via the Tavily CLI. Use this skill whenever the user wants to search the web, find articles, research a topic, look something up online, extract content from a URL, grab text from a webpage, crawl documentation, download a site's pages, discover URLs on a domain, or conduct in-depth research with citations. Also use when they say "fetch this page", "pull the content from", "get the page at https://", "find me articles about", or referen
Security Assessment
Detected risks:
About tavily-cli
The `tavily-cli` skill enables advanced web search, content extraction, site crawling, URL discovery, and deep research directly from the command line. It addresses the challenge of gathering accurate, comprehensive information from the web efficiently, going beyond simple search queries. By leveraging Tavily's CLI, users can fetch and extract content from URLs, map site structures, crawl large sections of websites, and perform multi-source research with citations. This is especially useful for scenarios where agents or standard web tools may fall short in organizing and delivering structured, LLM-optimized information.
Key capabilities of the skill include executing targeted web searches, extracting page content from specific URLs, discovering URLs within a domain, bulk crawling sections of a site, and conducting in-depth research with source references. Each functionality is accessible through specific commands (`search`, `extract`, `map`, `crawl`, `research`) and supports structured JSON output for easy integration with downstream workflows. Additionally, commands can save results to files and read input from standard input, providing flexibility for automation and scripting. The CLI also provides robust authentication options via API keys or OAuth and clear exit codes for error handling.
This skill is ideal for developers, researchers, content analysts, and data engineers who require efficient web data retrieval and analysis. Use cases include finding articles on a topic, extracting documentation or knowledge from web pages, mapping unknown site structures, bulk downloading sections of websites, and conducting thorough research with citations. It is particularly valuable for those who need structured, agent-ready output for AI workflows or want to automate large-scale information gathering and processing tasks from external websites.
FAQ
How do I install and authenticate Tavily CLI?
You can install Tavily CLI using `curl -fsSL https://cli.tavily.com/install.sh | bash` or via package managers (`uv tool install tavily-cli` or `pip install tavily-cli`). Authentication can be done with `tvly login --api-key YOUR_KEY`, exporting `TAVILY_API_KEY`, or using OAuth with `tvly login`.
Which commands should I use for different web tasks?
Use `tvly search` to find pages, `tvly extract` to get a page's content, `tvly map` to discover URLs in a site, `tvly crawl` to bulk extract site sections, and `tvly research` for deep multi-source analysis with citations.
Can I get structured output from the commands?
Yes, all commands support `--json` for structured, machine-readable output and `-o` to save results to a file.
What are the prerequisites to use this skill?
You must have Tavily CLI installed and authenticated with a valid API key. Check readiness with `tvly --status`.
Are there any limitations or special tips for using the CLI?
Always quote URLs to avoid shell issues with special characters. Commands can read from stdin with `-`. Exit codes indicate success or different errors: 0 = success, 2 = bad input, 3 = auth error, 4 = API error.
Install tavily-cli
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
tavily-ai/skills