Tavily
A RocketRide tool node that gives an agent live web-search results from Tavily. Pick it when an agent needs current web pages in a compact search result, rather than a general HTTP request or a static knowledge source.
About Tavily
Tavily provides search and research APIs intended for AI applications. Its search response combines result URLs, titles, snippets, and relevance information for programmatic use.
What it does
The node has no data lanes and registers one real-time search function. It sends the configured defaults and any supported per-call overrides to the Tavily search endpoint, then returns structured result records. Use it for retrieval during an agent run; it is experimental, so callers should handle service errors rather than assuming a search always succeeds.
As a tool
The prefix defaults to tavily, so the registered function is tavily.tavily.
| Function | Description |
|---|---|
tavily.tavily | Search the web with a required natural-language query. |
Optional arguments are max_results (1–20), search_depth (basic or advanced), topic (general, news, or finance), time_range (day, week, month, or year), and include_domains / exclude_domains. A successful response includes success, the query, num_results, and results; a failed request returns success: false with an error string.
Configuration
Set the API key, then use the defaults as a sensible baseline. Call-level arguments override the configured result count, depth, and topic when a specific question needs a different search.
Max Results
The configured count must be 1–20 and defaults to 5. Increase it when the agent must compare multiple sources; keep it small for focused questions so the agent receives less irrelevant context.
Search Depth and Topic
advanced is the default depth, while basic is available for a simpler search. The topic default is general; choose news or finance when that category better matches the request. These settings remain defaults only—per-call values take precedence.
Authentication
Set apikey to a Tavily API key. An empty key prevents the node from performing a search.
Upstream docs
Schema
| Field | Type | Description | Default |
|---|---|---|---|
tool_tavily.apikey | string | API Key Tavily API key (from https://tavily.com) | "" |
tool_tavily.maxResults | integer | Max Results Maximum number of search results to return (1-20) | 5 |
tool_tavily.searchDepth | string | Search Depth Tavily search depth | "advanced" |
tool_tavily.topic | string | Topic Search topic category | "general" |
Dependencies
requests