From 8f0e11fab773fe21d7aedc8032343eebe243ee34 Mon Sep 17 00:00:00 2001 From: Kesku Date: Sun, 25 Jan 2026 17:25:07 -0800 Subject: [PATCH] add search provider table --- docs/tools/web.md | 10 +++++++++- src/agents/tools/web-search.ts | 2 +- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/tools/web.md b/docs/tools/web.md index 038ee1fce..a9d5c325f 100644 --- a/docs/tools/web.md +++ b/docs/tools/web.md @@ -25,6 +25,14 @@ These are **not** browser automation. For JS-heavy sites or logins, use the See [Perplexity Search setup](/perplexity) and [Brave Search setup](/brave-search) for provider-specific details. +## Choosing a search provider + +| Provider | Pros | Cons | API Key | +|---------------------------|----------------------------------------------------------------------------------------------|-------------------------------|------------------------------------------------| +| **Perplexity Search API** | Fast, structured results; domain, language, region, and freshness filters; content extraction options; free credits for Clawdbot users | — | Requires Perplexity API key `PERPLEXITY_API_KEY` | +| **Brave Search API** | Fast, structured results; free tier available | Fewer filtering options | Requires Brave API key `BRAVE_API_KEY` | + + Set the provider in config: ```json5 @@ -49,7 +57,7 @@ Use `clawdbot configure --section web` to set up your API key and choose a provi 2) Generate an API key in the dashboard 3) Run `clawdbot configure --section web` to store the key in config, or set `PERPLEXITY_API_KEY` in your environment. -Perplexity provides $5 in API credits on a monthly rolling basis to Perplexity Pro subscribers. Check the Perplexity API docs for current limits and pricing. +Perplexity provides $5 in API credits on a monthly rolling basis to Perplexity Pro subscribers. Additionally, Perplexity provides complementary credits for Clawdbot users. See [Perplexity Search API Docs](https://docs.perplexity.ai/guides/search-quickstart) for more details. diff --git a/src/agents/tools/web-search.ts b/src/agents/tools/web-search.ts index ba83628ce..98111e825 100644 --- a/src/agents/tools/web-search.ts +++ b/src/agents/tools/web-search.ts @@ -352,7 +352,7 @@ async function runPerplexitySearchApi(params: { const data = (await res.json()) as PerplexitySearchApiResponse; const results = Array.isArray(data.results) ? data.results : []; - // Map to match Brave's format + // Map to align formats return results.map((entry) => ({ title: entry.title ?? "", url: entry.url ?? "",