| name | tavily-deep-research |
| description | Advanced web search, content extraction, and site mapping through Tavily via SandBase. Use when asked for web research, URL content extraction, full article reading, news search, or site structure discovery. |
Tavily Deep Research
Advanced web search and content extraction through SandBase's Tavily integration. Search the web with depth control, extract clean content from URLs, and discover site structures. Read the API map before selecting a capability.
Call SandBase capabilities
For every selected tool, call sandbase_describe_tool first and use only arguments in its current input schema. Then call sandbase_call_tool with the exact tool_name.
Operating principles
- Use Tavily for current, real-time web information that the model's training data may not cover.
- Cite sources with URLs for every factual claim.
- Use appropriate search depth: basic for quick checks, advanced for thorough research.
- Extract full content only when necessary — search snippets are often sufficient.
Workflow
1. Search the web
Use tavily_search with parameters:
search_depth: "basic" for quick validation, "advanced" for thorough research
topic: "general", "news", or "finance" to focus results
days: limit to recent results (e.g., 7 for past week)
max_results: 5-20 depending on coverage needs
include_domains / exclude_domains: filter by source
2. Extract content
Use tavily_extract to get clean, readable content from specific URLs.
- Use when search snippets aren't enough and full article text is needed.
- Works on most public web pages — not paywalled content.
3. Map site structure
Use tavily_map to discover all pages on a website.
- Use for competitor site analysis or content auditing.
- Returns site structure and page list.
Output
Return: search results with source URLs, extracted content summaries, site maps when relevant, and confidence indicators.
Example tasks
- "Search the web for the latest news about [topic] in the last 7 days."
- "Extract the full content from this article: [URL]."
- "Research [topic] — find 10 authoritative sources and summarize key findings."
- "Map all pages on [website URL] to understand their content structure."
- "Find recent news about [company] and summarize the key developments."