Brave-zoekopdracht

​

Een API-sleutel verkrijgen

1. Maak een Brave Search API-account aan op https://brave.com/search/api/
2. Kies in het dashboard het Search-abonnement en genereer een API-sleutel.
3. Sla de sleutel op in de configuratie of stel BRAVE_API_KEY in de Gateway-omgeving in.

​

Configuratievoorbeeld

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // of "llm-context"
            baseUrl: "https://api.search.brave.com", // optionele proxy-/basis-URL-overschrijving
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

• web (standaard): normale Brave-webzoekopdracht met titels, URL’s en fragmenten
• llm-context: Brave LLM Context API met vooraf geëxtraheerde tekstfragmenten en bronnen voor onderbouwing

​

Toolparameters

// Zoekopdracht specifiek voor land en taal
await web_search({
  query: "hernieuwbare energie",
  country: "DE",
  language: "de",
});

// Recente resultaten (afgelopen week)
await web_search({
  query: "AI-nieuws",
  freshness: "week",
});

// Zoeken binnen een datumbereik
await web_search({
  query: "AI-ontwikkelingen",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​

Opmerkingen

• OpenClaw gebruikt het Brave Search-abonnement. Als je een verouderd abonnement hebt (bijv. het oorspronkelijke Free-abonnement met 2.000 zoekopdrachten/maand), blijft dit geldig, maar bevat het geen nieuwere functies zoals LLM Context of hogere snelheidslimieten.
• Elk Brave-abonnement bevat $5/maand aan gratis tegoed (wordt vernieuwd). Het Search-abonnement kost $5 per 1.000 verzoeken, dus het tegoed dekt 1.000 zoekopdrachten/maand. Stel je gebruikslimiet in het Brave-dashboard in om onverwachte kosten te voorkomen. Zie de Brave API-portal voor de actuele abonnementen.
• Het Search-abonnement bevat het LLM Context-eindpunt en rechten voor AI-inferentie. Voor het opslaan van resultaten om modellen te trainen of af te stemmen, is een abonnement met expliciete opslagrechten vereist. Zie de Servicevoorwaarden van Brave.
• De modus llm-context retourneert onderbouwde bronvermeldingen in plaats van de normale fragmentstructuur voor webzoekopdrachten.
• De modus llm-context ondersteunt freshness en begrensde bereiken met date_after + date_before. Deze ondersteunt ui_lang niet; date_before zonder date_after wordt geweigerd, omdat Brave vereist dat aangepaste versheidsbereiken zowel een begin- als einddatum bevatten.
• ui_lang moet een regio-subtag bevatten, zoals en-US.
• Resultaten worden standaard 15 minuten in de cache opgeslagen (configureerbaar via cacheTtlMinutes).
• Aangepaste waarden voor webSearch.baseUrl worden opgenomen in de Brave-cache-identiteit, zodat proxyspecifieke antwoorden niet conflicteren.
• Schakel de diagnostische vlag brave.http in om tijdens probleemoplossing URL’s/queryparameters van Brave-verzoeken, de responsstatus/-timing en treffers, missers en schrijfbewerkingen van de zoekcache te loggen. De vlag logt nooit de API-sleutel of responsinhoud, maar zoekopdrachten kunnen gevoelig zijn.

​

Gerelateerd

• Overzicht van Web Search — alle providers en automatische detectie
• Perplexity Search — gestructureerde resultaten met domeinfiltering
• Exa Search — neuraal zoeken met inhoudsextractie