ericwang915 Tavily Web Search
When to Use
- Search the web for information
- Look up current events or news
- Research a topic with real-time results
- Check facts or verify claims
- Find data, articles, or summaries from the internet
When NOT to Use
- Scraping a specific URL's content — use
web_scraper - Calling a known API endpoint — use
http_request - GitHub or code-specific lookups — use
githubor search
Setup
- Get a free API key at app.tavily.com
- Add to
pythonclaw.json:"tavily": { "apiKey": "tvly-..." } - Install SDK:
pip install tavily-python
Usage/Commands
Use the built-in web_search tool — no script required.
| Parameter | Type | Description | Default |
|---|---|---|---|
query |
string | Search query (be specific) | required |
search_depth |
string | "basic" (fast) or "advanced" (thorough) |
"basic" |
topic |
string | "general", "news", or "finance" |
"general" |
max_results |
integer | Results count (1–20) | 5 |
time_range |
string | "day", "week", "month", "year" |
none |
Examples:
web_search(query="Python 3.13 new features")
web_search(query="AI industry news", topic="news", time_range="week", max_results=10)
web_search(query="NVIDIA stock analysis 2026", topic="finance", search_depth="advanced")
Notes
- Be specific in queries (e.g., "Python asyncio best practices 2026" vs "Python async")
- Use
topic="news"for current events,topic="finance"for market data - Use
time_rangewhen freshness matters - Always cite source URLs in your response