Web Search Tools

Tools for searching the web using the Tavily API.

Requirements

Set environment variable:

• TAVILYAPIKEY: Your Tavily API key

Basic Search

result = await tavily_search(
    query="latest Python release",
    max_results=5
)

Response format

{
  "success": true,
  "data": {
    "results": [
      {
        "title": "Result Title",
        "url": "https://example.com",
        "content": "Snippet of the page content...",
        "score": 0.95
      }
    ],
    "query": "latest Python release"
  }
}

Advanced Options

result = await tavily_search(
    query="machine learning tutorials",
    max_results=10,
    search_depth="advanced",
    include_domains=["github.com", "arxiv.org"],
    exclude_domains=["pinterest.com"]
)

Parameters

When to Use

• Finding current information not in training data
• Researching recent events or news
• Looking up documentation or tutorials
• Fact-checking with web sources