---
id: daily-tavily-cli
name: "tavily-cli"
url: https://skills.yangsir.net/skill/daily-tavily-cli
author: tavily-ai
domain: data-ai
tags: ["web-search", "information-retrieval", "cli-tools", "data-extraction", "ai-search"]
install_count: 7000
rating: 4.50 (93 reviews)
github: https://github.com/tavily-ai/skills
---

# tavily-cli

> Tavily命令行工具，提供强大的网络搜索、内容提取、网站爬取、URL发现及深度研究功能，助力高效获取网络信息。

**Stats**: 7,000 installs · 4.5/5 (93 reviews)

## Before / After 对比

### 中文

## Readme

# tavily-cli

# 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.

## Prerequisites

Must be installed and authenticated. Check with `tvly --status`.

```
tavily v0.1.0

> Authenticated via OAuth (tvly login)

```

If not ready:

```
curl -fsSL https://cli.tavily.com/install.sh | bash

```

Or manually: `uv tool install tavily-cli` / `pip install tavily-cli`

Then authenticate:

```
tvly login --api-key tvly-YOUR_KEY
# or: export TAVILY_API_KEY=tvly-YOUR_KEY
# or: tvly login  (opens browser for OAuth)

```

## 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.

```
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.

Weekly Installs281Repository[tavily-ai/skills](https://github.com/tavily-ai/skills)GitHub Stars95First Seen2 days agoSecurity Audits[Gen Agent Trust HubPass](/tavily-ai/skills/tavily-cli/security/agent-trust-hub)[SocketPass](/tavily-ai/skills/tavily-cli/security/socket)[SnykFail](/tavily-ai/skills/tavily-cli/security/snyk)Installed oncodex275cursor275opencode274kimi-cli273gemini-cli273amp273

---
*Source: https://skills.yangsir.net/skill/daily-tavily-cli*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-tavily-cli/markdown*