Exa Search
A RocketRide tool node that gives an AI agent live web search powered by Exa's semantic search.
Experimental: this node is marked
experimentaland may change.
What it does
When an agent calls the exa_search tool, the node runs a real-time search against the
Exa /search REST API and hands back structured results: title, URL, text content,
relevance score, published date, and author.
Implemented with the requests library, no Exa SDK is used. Requests time out after
30 seconds and are retried up to 3 times with exponential backoff (2 s base delay) on
rate limits (HTTP 429), server errors (5xx), and timeouts. Failures are returned to the
agent as a structured {"success": false, "error": ...} result rather than raised.
The node has no pipeline lanes (lanes is {}). Only agent runtimes reach it, through
the invoke capability.
Configuration
| Field | Type | Description |
|---|---|---|
apikey | string | Default empty. Exa API key (from https://exa.ai) |
numResults | integer | Default 10. Maximum number of search results to return (1-50) |
useAutoprompt | boolean | Default true. Let Exa optimize the query for better results |
searchType | string | Default "auto". Type of search to perform |
includeText | boolean | Default true. Include full text content in results |
The config values act as defaults, the agent can override num_results, type,
use_autoprompt, and include_text per call.
Available tools
exa_search
Search the web using Exa semantic search. query is the only required parameter.
| Tool | Description |
|---|---|---|
| exa_search | Search the web using Exa semantic search. Provide a natural language query to find relevant web pages. Returns structured results with title, URL, text content, relevance score, and published date. |
Returns an object with success, query, num_results, results (array of
{title, url, score, published_date, author, text?}, text only when content was
requested and returned), and error on failure.
Authentication
Drop your Exa API key into the API Key config field (grab one at https://exa.ai).
The field is encrypted at rest and masked in the UI. Alternatively, set the
EXA_API_KEY environment variable on the engine host, the config field takes
precedence when both are set. The key is sent to the Exa API in the x-api-key
request header.
Schema
| Field | Type | Description | Default |
|---|---|---|---|
tool_exa_search.apikey | string | API Key Exa API key (from https://exa.ai) | "" |
tool_exa_search.includeText | boolean | Include Text Content Include full text content in results | true |
tool_exa_search.numResults | integer | Number of Results Maximum number of search results to return (1-50) | 10 |
tool_exa_search.searchType | string | Search Type Type of search to perform | "auto" |
tool_exa_search.useAutoprompt | boolean | Use Autoprompt Let Exa optimize the query for better results | true |
Dependencies
requests