Ana içeriğe atla

Brave Search API

OpenClaw, web_search sağlayıcısı olarak Brave Search API’yi destekler.

API anahtarı alın

  1. https://brave.com/search/api/ adresinde bir Brave Search API hesabı oluşturun
  2. Kontrol panelinde Search planını seçin ve bir API anahtarı oluşturun.
  3. Anahtarı yapılandırmada saklayın veya Gateway ortamında BRAVE_API_KEY ayarlayın.

Yapılandırma örneği

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}
Sağlayıcıya özgü Brave arama ayarları artık plugins.entries.brave.config.webSearch.* altında bulunur. Eski tools.web.search.apiKey hâlâ uyumluluk shim’i üzerinden yüklenir, ancak artık kanonik yapılandırma yolu değildir. webSearch.mode, Brave taşımasını denetler:
  • web (varsayılan): başlıklar, URL’ler ve parçacıklarla normal Brave web araması
  • llm-context: dayanak sağlamak için önceden çıkarılmış metin parçaları ve kaynaklar içeren Brave LLM Context API

Araç parametreleri

ParameterDescription
queryArama sorgusu (gerekli)
countDöndürülecek sonuç sayısı (1-10, varsayılan: 5)
country2 harfli ISO ülke kodu (ör. "US", "DE")
languageArama sonuçları için ISO 639-1 dil kodu (ör. "en", "de", "fr")
search_langBrave arama dili kodu (ör. en, en-gb, zh-hans)
ui_langUI öğeleri için ISO dil kodu
freshnessZaman filtresi: day (24 sa), week, month veya year
date_afterYalnızca bu tarihten sonra yayımlanan sonuçlar (YYYY-MM-DD)
date_beforeYalnızca bu tarihten önce yayımlanan sonuçlar (YYYY-MM-DD)
Örnekler:
// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

Notlar

  • OpenClaw, Brave Search planını kullanır. Eski bir aboneliğiniz varsa (ör. ayda 2.000 sorgu içeren özgün Free planı), bu abonelik geçerliliğini korur ancak LLM Context veya daha yüksek oran sınırları gibi daha yeni özellikleri içermez.
  • Her Brave planı ayda $5 ücretsiz kredi içerir (yenilenir). Search planı 1.000 istek başına $5 maliyetlidir, bu nedenle kredi ayda 1.000 sorguyu kapsar. Beklenmedik ücretlerden kaçınmak için kullanım sınırınızı Brave kontrol panelinde ayarlayın. Güncel planlar için Brave API portalına bakın.
  • Search planı, LLM Context uç noktasını ve AI çıkarım haklarını içerir. Sonuçları modelleri eğitmek veya ayarlamak için depolamak, açık depolama hakları içeren bir plan gerektirir. Brave Hizmet Şartları bölümüne bakın.
  • llm-context modu, normal web araması parçacık şekli yerine dayanaklı kaynak girdileri döndürür.
  • llm-context modu ui_lang, freshness, date_after veya date_before desteklemez.
  • ui_lang, en-US gibi bir bölge alt etiketi içermelidir.
  • Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (cacheTtlMinutes ile yapılandırılabilir).

İlgili