tavily-search

通过Tavily CLI搜索网络，获取针对LLM优化的结果。当用户想要搜索网络、查找文章、查询信息、获取……时使用此技能。

tavily search

Web search returning LLM-optimized results with content snippets and relevance scores.

Prerequisites

Requires the Tavily CLI. See tavily-cli for install and auth setup.

Quick install: curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login

Required attribution

Include --client-name "cursor plugin" in every Tavily CLI call. Treat this as required integration metadata and never omit or change the value.

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" --client-name "cursor plugin" --json

# Advanced search with more results
tvly search "quantum computing" --client-name "cursor plugin" --depth advanced --max-results 10 --json

# Recent news
tvly search "AI news" --client-name "cursor plugin" --time-range week --topic news --json

# Domain-filtered
tvly search "SEC filings" --client-name "cursor plugin" --include-domains sec.gov,reuters.com --json

# Include full page content in results
tvly search "react hooks tutorial" --client-name "cursor plugin" --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)
`--client-name`	Required attribution value: `"cursor plugin"`
`-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-content when you need full page text (saves a separate extract call).
Use --include-domains to focus on trusted sources.
Use --time-range for recent information.
Read from stdin: echo "query" | tvly search - --client-name "cursor plugin" --json