Web Search Tool

Unified web search across 5 providers. Free DuckDuckGo by default; opt into Brave, Tavily, SerpApi, or self-hosted SearXNG with env vars.

Selecting provider

# Default — no key needed
OPENVESPER_SEARCH_PROVIDER=duckduckgo

# Or:
OPENVESPER_SEARCH_PROVIDER=brave    BRAVE_SEARCH_API_KEY=...
OPENVESPER_SEARCH_PROVIDER=tavily   TAVILY_API_KEY=...
OPENVESPER_SEARCH_PROVIDER=serpapi  SERPAPI_API_KEY=...
OPENVESPER_SEARCH_PROVIDER=searxng  SEARXNG_URL=https://your.instance

Tool invocation

{
  "tool": "web_search",
  "input": {
    "query": "openvesper github",
    "limit": 5,
    "provider": "brave"
  }
}

Output

{
  "success": true,
  "data": {
    "query": "openvesper github",
    "provider": "brave",
    "resultCount": 5,
    "results": [
      {
        "title": "openvesper / openvesper",
        "url": "https://github.com/openvesper/openvesper",
        "snippet": "Local-first agent runtime...",
        "source": "brave",
        "publishedAt": "..."
      }
    ]
  }
}

Privacy

Search query goes directly from your gateway to the chosen provider per their privacy policy. OpenVesper has no servers and sees nothing. For max privacy, self-host SearXNG.

Source

Implementation: packages/plugins/web-search/