Lead Bulma Araçları
Google Haritalar lead scraping işlerini başlatma, izleme ve sonuçları okuma araçları
Bu domain'de Google Haritalar tabanlı lead bulma için 5 araç bulunur. Tipik akış: start_scrape ile iş başlatılır, get_scrape_status ile takip edilir, sonuçlar list_leads ve get_lead ile okunur.
start_scrape aylık lead kotanızı tüketir ve hesap başına aynı anda yalnızca bir scrape çalışabilir. Kalan kotanızı görmek için get_workspace_usage aracını kullanın.
Araçlar
start_scrape
Google Haritalar lead-scraping işi başlatır. İş asenkron çalışır; sonucu get_scrape_status ile takip edin. Workspace sahibinin aylık lead kotasını tüketir ve scraping maliyeti doğurur. Kişi düzeyinde zenginleştirme (leads enrichment) seçenekleri Pro veya Team planı gerektirir.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
search_terms | string dizisi (1–5) | Evet | Arama sorguları, ör. ["diş kliniği", "diş hekimi"] |
country | string | Evet | Ülke adı, ör. "Turkey" |
country_code | string (2 harf) | Hayır | ISO ülke kodu, ör. "tr" |
city | string | Hayır | Şehir filtresi |
state | string | Hayır | Eyalet/il filtresi |
language | string | Hayır | Sonuç dili, ör. "tr" (varsayılan "en") |
results_per_term | number (1–6000) | Hayır | Terim başına sonuç sayısı (varsayılan 10) |
place_minimum_stars | enum | Hayır | Minimum puan: all, two, twoAndHalf, three, threeAndHalf, four, fourAndHalf (varsayılan all) |
maximum_leads_enrichment_records | number (1–10) | Hayır | Kişi düzeyinde zenginleştirmeyi açar (yalnızca Pro/Team) |
leads_enrichment_departments | enum dizisi | Hayır | Zenginleştirilecek departmanlar, ör. sales, marketing, c_suite |
AI'a şöyle yazın: "Ankara'daki diş kliniklerini bul, 100 tane yeter. En az 4 yıldızlı olanları istiyorum."
get_scrape_status
Tek bir scrape işinin güncel durumunu (pending, running, completed, failed) sonuç sayısıyla birlikte döndürür. start_scrape çağrısından sonra bununla takip edin.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
scrape_job_id | string (UUID) | Evet | start_scrape çıktısındaki iş ID'si |
AI'a şöyle yazın: "Az önce başlattığımız scrape bitti mi? Durumuna bak."
list_scrape_jobs
Bir workspace'in son lead-scraping işlerini durum ve sonuç sayılarıyla listeler.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
status | enum | Hayır | pending, running, completed, failed |
limit | number (1–200) | Hayır | Döndürülecek satır sayısı (varsayılan 50) |
offset | number | Hayır | Atlanacak satır sayısı (sayfalama) |
AI'a şöyle yazın: "Son scrape işlerimi ve kaç sonuç getirdiklerini göster."
list_leads
Bir workspace'in lead'lerini (scrape edilmiş Google Haritalar işletmeleri) sayfalı listeler. İşletme adında serbest metin araması, şehir, kategori, e-postası olanlar ve favoriler filtreleri vardır. Arşivlenen lead'ler include_archived verilmedikçe hariç tutulur.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
search | string | Hayır | İşletme adında arama |
city | string | Hayır | Şehir filtresi |
category | string | Hayır | Kategori filtresi |
has_email | boolean | Hayır | Yalnızca en az bir e-postası olan lead'ler |
favorites_only | boolean | Hayır | Yalnızca favoriler |
include_archived | boolean | Hayır | Arşivlenmişleri de dahil et (varsayılan false) |
limit / offset | number | Hayır | Sayfalama (limit varsayılan 50, en fazla 200) |
AI'a şöyle yazın: "Ankara'daki lead'lerden e-posta adresi olanları listele."
get_lead
Tek bir lead'in tüm detayını döndürür: iletişim bilgileri, sosyal medya hesapları, puanlar, zenginleştirme verisi ve workspace düzeyindeki durum alanları.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
lead_id | string | Evet | Lead satır ID'si (list_leads çıktısından) |
AI'a şöyle yazın: "Listedeki 'Dentalya Kliniği' lead'inin tüm detaylarını göster."
Lead'lerin notlarını ve durumlarını güncellemek için Veri Havuzu Araçları, lead'i CRM'e taşımak için CRM Yazma Araçları sayfasındaki promote_lead_to_crm aracına bakın.