Tavily Web Search Skill

Search the web using the Tavily AI search API, optimized for LLM applications.

Authentication

Set the TAVILY_API_KEY environment variable with your Tavily API key. Get your key at https://tavily.com

No OAuth or MCP configuration required.

Quick Start

./scripts/tavily-search.sh '{"query": "latest AI news"}'

Tool: tavily_search

Search the web using Tavily AI.

Input:

Parameter	Type	Required	Description
query	string	yes	The search query
search_depth	string	no	basic (fast) or advanced (thorough). Default: basic
max_results	integer	no	Maximum results to return (1-20). Default: 5
time_range	string	no	Filter by time: day, week, month, year
include_domains	array	no	Only include results from these domains
exclude_domains	array	no	Exclude results from these domains

Output: JSON object with query, answer, results (array of {title, url, content, score}), and response_time.

Search Depth

Depth	Speed	Detail	Use Case
basic	Fast (~1s)	Standard snippets	Quick lookups, fact checks
advanced	Slower (~3s)	Detailed content	Research, analysis

Response Format

{
  "query": "your search query",
  "answer": "AI-generated summary answer",
  "response_time": 0.5,
  "results": [
    {
      "title": "Page Title",
      "url": "https://example.com",
      "content": "Relevant content snippet...",
      "score": 0.95
    }
  ]
}

Tips

• Use search_depth: advanced for research tasks that need detailed content
• Use include_domains to restrict searches to trusted sources
• Use time_range: day for breaking news or very recent information
• The answer field provides a concise AI-generated summary when available