Tools

Brave araması

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

API anahtarı edinme

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

Yapılandırma örneği

json5

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // veya "llm-context"            baseUrl: "https://api.search.brave.com", // isteğe bağlı proxy/temel URL geçersiz kılması          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Sağlayıcıya özgü Brave arama ayarları plugins.entries.brave.config.webSearch.* altında bulunur; standart yapılandırma yolu budur. Paylaşılan üst düzey tools.web.search.apiKey ve kapsamlı tools.web.search.brave.* yolları uyumluluk birleştirmesi aracılığıyla yüklenmeye devam eder, ancak yeni yapılandırmalar yukarıdaki Plugin kapsamlı yolu kullanmalıdır.

webSearch.mode, Brave aktarımını denetler:

web (varsayılan): başlıklar, URL'ler ve parçacıklarla normal Brave web araması
llm-context: temellendirme için önceden ayıklanmış metin parçaları ve kaynaklar sunan Brave LLM Context API

webSearch.baseUrl, Brave isteklerini güvenilir ve Brave uyumlu bir proxy'ye veya gateway'e yönlendirebilir. OpenClaw, yapılandırılan temel URL'ye /res/v1/web/search ya da /res/v1/llm/context ekler ve temel URL'yi önbellek anahtarında tutar. Genel uç noktalar https:// kullanmalıdır; http:// yalnızca güvenilir local loopback veya özel ağ proxy ana makineleri için kabul edilir.

Araç parametreleri

querystringrequired

Arama sorgusu.

countnumberdefault: 5

Döndürülecek sonuç sayısı (1–10).

countrystring

2 harfli ISO ülke kodu (ör. US, DE).

languagestring

Arama sonuçları için ISO 639-1 dil kodu (ör. en, de, fr).

search_langstring

Brave arama dili kodu (ör. en, en-gb, zh-hans).

ui_langstring

Kullanıcı arayüzü öğeleri için ISO dil kodu.

freshness'day' | 'week' | 'month' | 'year'

Zaman filtresi — day 24 saattir.

date_afterstring

Yalnızca bu tarihten sonra yayımlanan sonuçlar (YYYY-MM-DD).

date_beforestring

Yalnızca bu tarihten önce yayımlanan sonuçlar (YYYY-MM-DD).

Örnekler:

javascript

// Ülkeye ve dile özgü aramaawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Son sonuçlar (geçen hafta)await web_search({  query: "AI news",  freshness: "week",}); // Tarih aralığı araması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 sunan ilk Free planı), abonelik geçerliliğini korur ancak LLM Context veya daha yüksek hız sınırları gibi yeni özellikleri içermez.
Her Brave planı, her ay yenilenen aylık $5 ücretsiz kredi içerir. Search planının maliyeti 1.000 istek başına $5 olduğundan kredi, ayda 1.000 sorguyu karşılar. Beklenmeyen ücretlerden kaçınmak için Brave kontrol panelinde kullanım sınırınızı ayarlayın. Güncel planlar için Brave API portalına bakın.
Search planı, LLM Context uç noktasını ve yapay zekâ çıkarım haklarını içerir. Modelleri eğitmek veya ayarlamak amacıyla sonuçları saklamak, açık depolama hakları sunan bir plan gerektirir. Brave Hizmet Şartlarına bakın.
llm-context modu, normal web araması parçacığı biçimi yerine kaynaklara dayalı girdiler döndürür.
llm-context modu, freshness ile sınırlandırılmış date_after + date_before aralıklarını destekler. ui_lang desteklenmez; Brave özel güncellik aralıklarının hem başlangıç hem de bitiş tarihini içermesini gerektirdiğinden date_after olmadan date_before kullanımı reddedilir.
ui_lang, en-US gibi bir bölge alt etiketi içermelidir.
Sonuçlar varsayılan olarak 15 dakika boyunca önbelleğe alınır (cacheTtlMinutes aracılığıyla yapılandırılabilir).
Özel webSearch.baseUrl değerleri Brave önbellek kimliğine dahil edilir; böylece proxy'ye özgü yanıtlar çakışmaz.
Sorun giderme sırasında Brave istek URL'lerini/sorgu parametrelerini, yanıt durumunu/zamanlamasını ve arama önbelleği isabet/kaçırma/yazma olaylarını günlüğe kaydetmek için brave.http tanılama bayrağını etkinleştirin. Bayrak, API anahtarını veya yanıt gövdelerini hiçbir zaman günlüğe kaydetmez ancak arama sorguları hassas olabilir.

İlgili içerikler

Web Aramasına genel bakış -- tüm sağlayıcılar ve otomatik algılama
Perplexity Araması -- alan adı filtrelemeli yapılandırılmış sonuçlar
Exa Araması -- içerik ayıklamalı sinir ağı tabanlı arama

Was this useful?