Labsco
tavily-ai logo

tavily-cli

โ˜… 399

by tavily-ai ยท part of tavily-ai/skills

Web search, content extraction, site crawling, and deep research via Tavily CLI. Five command modes covering search, extraction, URL discovery, bulk crawling, and multi-source research with citations All commands support JSON output and file saving for structured, agentic workflows Escalation pattern guides you from simple search through extraction, mapping, crawling, to comprehensive research based on your needs Requires tavily-cli installation and API key authentication via tvly login

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeQuick setup
๐Ÿงฉ One of 7 skills in the tavily-ai/skills package โ€” works on its own, and pairs well with its siblings.

Web search, content extraction, site crawling, and deep research via Tavily CLI. Five command modes covering search, extraction, URL discovery, bulk crawling, and multi-source research with citations All commands support JSON output and file saving for structured, agentic workflows Escalation pattern guides you from simple search through extraction, mapping, crawling, to comprehensive research based on your needs Requires tavily-cli installation and API key authentication via tvly login

Inspect the full instructions your agent will receiveExpand

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, content extraction, site crawling, and deep research via Tavily CLI. Five command modes covering search, extraction, URL discovery, bulk crawling, and multi-source research with citations All commands support JSON output and file saving for structured, agentic workflows Escalation pattern guides you from simple search through extraction, mapping, crawling, to comprehensive research based on your needs Requires tavily-cli installation and API key authentication via tvly login npx skills add https://github.com/tavily-ai/skills --skill tavily-cli Download ZIPGitHub399

Tavily CLI

Web search, content extraction, site crawling, URL discovery, and deep research. Returns JSON optimized for LLM consumption.

Run tvly --help or tvly <command> --help for full option details.

Workflow

Follow this escalation pattern โ€” start simple, escalate when needed:

  • Search โ€” No specific URL. Find pages, answer questions, discover sources.

  • Extract โ€” Have a URL. Pull its content directly.

  • Map โ€” Large site, need to find the right page. Discover URLs first.

  • Crawl โ€” Need bulk content from an entire site section.

  • Research โ€” Need comprehensive, multi-source analysis with citations.

Need Command When Find pages on a topic tvly search No specific URL yet Get a page's content tvly extract Have a URL Find URLs within a site tvly map Need to locate a specific subpage Bulk extract a site section tvly crawl Need many pages (e.g., all /docs/) Deep research with citations tvly research Need multi-source synthesis

For detailed command reference, use the individual skill for each command (e.g., tavily-search, tavily-crawl) or run tvly <command> --help.

Output

All commands support --json for structured, machine-readable output and -o to save to a file.

Copy & paste โ€” that's it
tvly search "react hooks" --json -o results.json
tvly extract "https://example.com/docs" -o docs.md
tvly crawl "https://docs.example.com" --output-dir ./docs/

Tips

  • Always quote URLs โ€” shell interprets ? and & as special characters.

  • Use --json for agentic workflows โ€” every command supports it.

  • Read from stdin with - โ€” echo "query" | tvly search -

  • Exit codes: 0 = success, 2 = bad input, 3 = auth error, 4 = API error.