tavily-deep-research

# 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](references/sandbase-api-map.md) before selecting a capability.

## Call SandBase capabilities

Use the capability identifiers below as discovery hints, not MCP tool names. Find the matching endpoint with `sandbase_discover(q: "<provider and capability>")`; use its returned `name` in `sandbase_inspect(name: "<returned name>")`. Read `inputSchema`, pricing, and `execute_as`, then call `sandbase_run` using `execute_as.arguments.name` and schema-defined `arguments`. If a `run_id` is returned, poll `sandbase_run_get(run_id: "<returned run_id>")` within the task budget until `completed` or `failed`; report pending or failed runs without resubmitting them automatically.

## 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."

Shown under the source repo’s Apache-2.0 license. Read the full folder on GitHub.