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: advancedfor research tasks that need detailed content - Use
include_domainsto restrict searches to trusted sources - Use
time_range: dayfor breaking news or very recent information - The
answerfield provides a concise AI-generated summary when available