ExAthena.Tools.WebSearch (ExAthena v0.17.0)

Copy Markdown View Source

Search the web and return ranked results (title, url, snippet).

Use this to discover sources, then web_fetch the most relevant URL to read it in full. The search backend (DuckDuckGo / Tavily / Brave / SearXNG) is chosen by the host via config :ex_athena, :search — the agent never picks a provider. All backend access goes through the ExAthena.Search behaviour, so this tool never talks to an HTTP client directly.

Arguments:

  • query (required) — the search query.
  • max_results (optional, default 5, capped at 20).
  • topic (optional, "general" | "news").

  • recency (optional, e.g. "week", "month").
  • timeout_ms (optional, default 10_000).