Bu rehberde: Ajanlara web araması yetisi verirsiniz. Serper, Google arama sonuçlarını sağlar. Ücretsiz 2.500 sorguyla başlarsınız; kurulum 3 dakika sürer.
⏱ 5 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | SERPER |
| Kategori | Araştırma |
| Kimlik doğrulama | API anahtarı |
| Kapsam | Organizasyon geneli; tüm projeler paylaşır |
| Webhook | Hayır |
| Yetenekler | Web araması |
| Kullanan kutular | Web araması |
| Kullanan ajanlar | Content Creator, Lead Researcher, Lead Qualifier, Market Analyst, Competitor Analyst, SEO & Traffic, Campaign Planner, AI Chatbot, Custom |
Ne işe yarar?
Serper canlı Google arama sonuçlarını verir: organik sonuçlar, haberler, "insanlar şunu da soruyor" kutusu. OrqLabs'ta web araması aracının varsayılan sağlayıcısıdır. Bağlı değilse platform anahtarı kullanılır; o da yoksa arama aracı kapalı kalır ve ajanlar yalnızca verdiğiniz adreslerle çalışır.
Ön koşullar
- serper.dev hesabı. Kayıtta 2.500 ücretsiz sorgu verilir.
- Ücretli kullanım için kredi paketi.
Adım adım kurulum
A) Serper
- ① serper.dev → Sign up (Google veya e-posta).
- ② Dashboard açılır.
- ① API Key kutusundan anahtarı Copy ile kopyalayın. Anahtar sabittir; Regenerate eskisini geçersiz kılar.
- ② Usage sekmesinde kalan kredi; Billing ile satın alma.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Serper (Google Search API) → Bağla. ② Organizasyon geneli; proje seçilmez.
- ① API key alanına yapıştırın.
- ③ Bağla. Bağlantıyı test et tek bir arama yapar (1 kredi) ve kalan krediyi gösterir.
Serper ve Tavily aynı anda bağlıysa Web araması kutusunda hesap seçersiniz; ajanlar için varsayılan Serper'dır.
Ülke ve dil
- Web araması kutusunun Country code alanı (varsayılan
tr) Serper ülke ve dil ayarına eşlenir. - Ajanlar projenin dilinden (
tr-TR) ülke/dili türetir; yurt dışı araştırma için görevde "İngilizce kaynaklarda ara" deyin.
Limitler
| Konu | Sınır |
|---|---|
| Ücretsiz kredi | 2.500 sorgu (tek seferlik) |
| Fiyat | 1.000 sorgu başına ≈ 0.30–1.00 $ |
| Sorgu başına kredi | 1 (büyük sayfalar 2) |
| Hız sınırı | Saniyede 50-300; OrqLabs ajan başına eşzamanlı 3 |
| Sonuç | İstek başına 10-100 (kutu en fazla 50) |
Tipik tüketim: Lead Researcher 10-20 sorgu/çalıştırma, Market Analyst derin 30-60, Content Creator 0-3.
Bağlantıyı test etme
② Bağlantıyı test et bir arama yapıp ilk sonucu ve kalan krediyi döndürür.
Kimlik bilgilerini yenileme
- Dashboard → Regenerate API key → yeni anahtarı entegrasyon kartı → Kimlik bilgileri → Güncelle → API key alanına girin. Eski anahtar anında geçersizdir; kısa pencerede yapın.
- Kredi bittiğinde istekler 403/429 döner; Billing'den kredi alın.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401/403 | Anahtar yanlış | Dashboard'dan kopyalayın |
RATE_LIMIT – 429 | Saniye sınırı | Eşzamanlılığı düşürün |
RATE_LIMIT – 403 "Not enough credits" | Kredi bitti | Kredi satın alın; hızlı tarama |
INVALID – 400 "q is required" | Boş sorgu ifadesi | İfadeyi kontrol edin |
| Sonuçlar İngilizce | Ülke ayarı | country: tr; proje dili |
| Ajan "arama yapamadım" diyor | Anahtar yok | Serper veya Tavily bağlayın |
Serper mi Tavily mi?
| Kriter | Serper | Tavily |
|---|---|---|
| Sonuç | Ham Google sonuçları | Yapay zekâ için özetlenmiş içerik |
| Fiyat | Sorgu başına düşük | Kredi bazlı |
| Kullanım | Aday araştırma, SEO, rakip takibi | Pazar araştırması, uzun içerik |
| Ülke hedefleme | Güçlü | Temel |
İkisini de bağlayabilirsiniz.
Sık sorulan sorular
Ücretsiz kredi biterse ajanlar durur mu? Arama aracı hata verir; ajan aramasız devam eder ama sonuç zayıflar. Kredi alın veya Tavily bağlayın.
Her proje için ayrı anahtar gerekir mi? Hayır. Organizasyon geneli tek anahtar tüm projelerde çalışır; kredi tek havuzdan düşer.
Hangi ajanlar kullanır? Web araması yapan tüm ajanlar: araştırma, aday bulma, içerik, SEO.