Brave Search MCP

Brave Search API'sini AI'a bağlayan MCP sunucusu. AI'ın knowledge cutoff sonrası olayları, güncel belgeleri ve yerel arama sonuçlarını çekmesini sağlar. Web + local arama, news, suggestion API'leri mevcut.

Ne işe yarar?

• Güncel bilgi: "En son X sürümünde ne değişti?" — AI'ın eğitim verisinde yok, arar
• Haber / olaylar: "Son 24 saatte şu konuda ne oldu?"
• Teknik referans: "Şu hatayı çözenler ne yapmış?" (Stack Overflow, GitHub Issues)
• Karşılaştırma araştırması: "X kütüphanesi vs Y kütüphanesi" — blog + benchmark
• Yerel arama: "Yakınımda en iyi 3 kafe" — local.brave.com
• Fact-check: AI'ın söylediği bir şeyi doğrulatmak
• Kaynak toplama: Rapor yazarken referans arama

Yetenekler

Tool	Açıklama
brave_web_search	Genel web araması — snippet + URL listesi
brave_local_search	Yerel (coğrafi) arama — işletme, restoran, mekan

Sonuçlar: başlık, URL, snippet (kısa pasaj). Tam sayfa içeriği için Puppeteer MCP ile combined kullan.

Kurulum

1. Brave Search API key al

api.search.brave.com → sign up → API key oluştur.

Plan:

• Free tier: ayda 2000 query, 1 QPS (rate limit)
• Pro tier: saatte binlerce query, daha fazla özellik (news, video ayrı)

API key BSA_... ile başlar.

2. Kur

Claude Code:

claude mcp add brave-search \
  --env BRAVE_API_KEY=BSA_your_key \
  -- npx -y @modelcontextprotocol/server-brave-search

Claude Desktop / Cursor:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSA_your_key"
      }
    }
  }
}

Güvenlik ve gizlilik

• Brave'in gizlilik vaadi: sorgu profili tutmaz, personalize etmez. Yine de sorduğun her şey Brave'in sunucularına gider.
• API key sızarsa: dashboard'dan anında revoke. Rate limit istismarı maddi maliyet oluşturabilir.
• Hassas sorgu: PII, gizli şirket bilgisi sorgu'ya yazma — 3. parti'ye gitmiş olur.
• Children data uyumluluğu gerekiyorsa (COPPA vb.): farklı bir arama sağlayıcı düşün.

Örnek kullanımlar

Güncel sürüm bilgisi

"Node.js 22'nin stable release tarihi ne, LTS durumu nasıl?"

AI brave_web_search → sonuçları okur → özet.

Teknik sorun araştırması

"'Module not found: Error: Can't resolve 'fs' in Next.js' hatasını arayıp topluluktaki çözümleri özetle."

Yerel arama

"Kadıköy'de geç saate kadar açık, laptop çalışılabilir 3 kafe öner."

Combined: Search + fetch

Puppeteer ile birleştir:

"Next.js 16 breaking changes için en iyi 3 blog yazısını bul, sonra tam içeriklerini oku ve ortak konuları çıkar."

1. Brave search → URL listesi
2. Her URL için Puppeteer navigate + text extraction
3. Özet

Rapor hazırlama

"'Türkiye'de 2026 e-ticaret büyüme oranları' için 5-7 güvenilir kaynak bul, her biri için kısa not al, kaynakça ekle."

Sınırlar

• Tam içerik dönmüyor — sadece snippet. Full content için ayrı fetch
• Real-time değil — Brave crawl döngüsüne bağlı (genelde saatler/günler içinde güncel)
• Komşu resim, video ayrı endpoint'ler — bu MCP temel web + local
• Özelleştirme sınırlı — country filter, freshness var ama deep filter yok
• API maliyet: free tier hızla doluyor, production use Pro gerek
• Türkçe/yerel sonuçlar: country=TR parametresi otomatik set edilmiyor — kullanıcı explicit "Türkçe" demeli

Sorun giderme

Belirti	Sebep	Çözüm
401 Unauthorized	API key yanlış	Dashboard'dan yeniden kopyala
429 Too Many Requests	Rate limit (1 QPS free)	Araları aç veya Pro'ya geç
Boş sonuçlar	Sorgu çok spesifik	Genelleştir, tırnaklı frase deneme
Yavaş	Brave API latency	Normal 200-500ms, 2s+ ise durum sayfası kontrol

Doğrulama

/mcp

Sonra AI'a:

"Brave ile 'OpenAI DevDay 2026' ara, ilk 3 sonucu göster."

Alternatifler

• Tavily MCP (tavily.com) — AI-optimized search, summary included
• Exa MCP — neural / vector search, research-oriented
• Google / Bing — resmi MCP yok, community wrappers var (rate limit yüksek maliyet)
• DuckDuckGo — API'sı yok ama HTML scrape ile topluluk MCP'leri var

---

Resmi repo: github.com/modelcontextprotocol/servers · Anthropic maintained