tavily-ai/skills · Official

tavily-search

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 d…

All-time #721 Trending #1123 Hot #6437 First seen Mar 16, 2026
8-week activity · all time api

Installation

$ npx skills add tavily-ai/skills --skill tavily-search

Summary

  • Web search with LLM-optimized results, content snippets, and relevance scores.
  • Supports four search depths (ultra-fast, fast, basic, advanced) with configurable result counts up to 20, plus domain filtering and time-range constraints Returns structured JSON output with content snippets, relevance scores, and metadata optimized for LLM consumption Includes specialized search modes for news and finance topics, with optional AI-generated answers and full page content extraction Integrates into multi-step research workflows: search → extract → map → crawl → research

Stronger alternatives

Audit results are mixed — compare nearby options before installing.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Mar 17, 2026

This skill provides web search functionality using the Tavily CLI. It includes a recommended installation method from the vendor's official domain and allows for command-line search operations. While the skill processes untrusted web content which can be a source of indirect prompt injection, this is inherent to its search function.

snyk CRITICAL

Analyzed Mar 17, 2026

[CRITICAL] E005: Suspicious download URL detected in skill instructions. [MEDIUM] W011: Third-party content exposure detected (indirect prompt injection risk). [MEDIUM] W012: Unverifiable external dependency detected (runtime URL that controls agent).

socket Score 0.9000 · 0 alerts

Analyzed Mar 18, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from tavily-ai/skills · top by installs.

npx skills add tavily-ai/skills

Browse all from tavily-ai/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 477
License LICENSE
Default branch main
Open issues 4
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsBash(tvly *)

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,138 B
  • docs SUMMARY.md 528 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 31,512 installs

SKILL.md

tavily search

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

Before running

Run search directly when tvly is available. Search supports capped keyless access, so do not look for an API key or authenticate before the first request.

If tvly is missing, follow the [tavily-cli setup](../tavily-cli/SKILL.md#setup) before retrying. If the keyless cap is reached in an interactive session, run tvly login to open browser OAuth, then retry the original search once. In an unattended environment, report the cap and authentication options instead of starting an interactive flow. Do not start a second login immediately after guided setup has completed.

When to use

  • You need to find information on any topic
  • You don't have a specific URL yet
  • First step in the [workflow](../tavily-cli/SKILL.md): 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 the JSON response to a 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.
  • Verify identity-sensitive facts at the exact primary source. For releases,

versions, ownership, or similarly named projects, confirm the official repository or domain instead of trusting a generated answer or package-name match alone.

  • Read from stdin: echo "query" | tvly search - --json

See also

  • [tavily-extract](../tavily-extract/SKILL.md) — extract content from specific URLs
  • [tavily-research](../tavily-research/SKILL.md) — comprehensive multi-source research