Web Search
Search the web using AI-optimized search providers. Supports Tavily and SerpAPI backends.
For a zero-config option that doesn’t require an API key, use the DuckDuckGo toolkit instead.
Quick Start
import { Agent, openai, WebSearchToolkit } from "@radaros/core";
const search = new WebSearchToolkit({
provider: "tavily",
// Uses TAVILY_API_KEY env var
});
const agent = new Agent({
name: "researcher",
model: openai("gpt-4o"),
instructions: "Search the web and provide sourced answers.",
tools: [...search.getTools()],
});
const result = await agent.run("Latest developments in AI agents 2026");
Config
provider
'tavily' | 'serpapi'
required
Search provider to use.
API key. Falls back to TAVILY_API_KEY or SERPAPI_API_KEY env var.
Default maximum results per search.
| Tool | Description |
|---|
web_search | Search the web. Returns titles, URLs, and snippets. Tavily also returns an AI-generated answer. |
Providers
Tavily
Best for AI agents — returns an AI-generated answer alongside search results.
export TAVILY_API_KEY="tvly-..."
SerpAPI
Google search results via API.
export SERPAPI_API_KEY="..."
