💥 xCodeWraith tarafından geliştirildi
Doğal dil sohbeti ile Google Haritalar'dan işletme potansiyel müşterilerini çıkaran ve zenginleştiren konuşmalı AI ajanı.
AI ile basitçe sohbet edin: "Los Angeles'ta 100 diş kliniği bul" ve otomatik olarak verileri toplamasını, zenginleştirmesini ve Google Sheets'e düzenlemesini izleyin.
- Genel Bakış
- Temel Özellikler
- Nasıl Çalışır
- Teknoloji Yığını
- Gereksinimler
- Kurulum
- Yapılandırma
- Kullanım Örnekleri
- Veri Alanları
- Sorun Giderme
- Lisans
Google Haritalar AI Ajanı, Google Haritalar'ı güçlü bir B2B potansiyel müşteri oluşturma aracına dönüştüren akıllı bir konuşma sistemidir. Manuel olarak işletme verilerini aramak ve kopyalamak yerine, gereksinimlerinizi anlayan ve tüm süreci otomatikleştiren bir AI ajanı ile sohbet edin.
- 🤖 Doğal Dil Arayüzü - İnsan bir asistanla konuşur gibi doğal sohbet
- 🧠 AI Destekli Anlama - GPT-4o isteklerinizi akıllıca yorumlar
- 🔄 Otomatik Zenginleştirme - E-postaları ve şirket geçmişlerini otomatik bulur
- 📊 Akıllı Organizasyon - Google Sheets'te verileri mükemmel şekilde yapılandırır
- ⚡ Gerçek Zamanlı İşleme - Sohbet ederken potansiyel müşterilerin dolmasını izleyin
| Hedef Kitle | Kullanım |
|---|---|
| 💼 Satış Ekipleri | Konum ve nişe göre hedefli potansiyel müşteri listeleri |
| 📞 Soğuk Aramacılar | Telefon numaralarını ve işletme bilgilerini anında alın |
| 📧 E-posta Pazarlamacıları | E-posta zenginleştirmesi ile iletişim bilgileri |
| 🏢 B2B Ajansları | Müşteriler için yerel işletme araştırması |
| 🚀 Girişimciler | Potansiyel müşteriler veya ortaklar bulun |
- Doğal dil girişi: "NYC'de 50 restoran bul"
- Karmaşık formlar veya parametreler yok
- AI bağlamı ve niyeti anlıyor
- Çok turlu konuşmalar
- Serper.dev Google Maps API üzerinden arama
- Sayfalamayı otomatik yönetir
- Kapsamlı işletme verilerini çıkarır
- Koordinatlarla coğrafi hedefleme
- Perplexity AI şirket e-postalarını buluyor
- Web sitelerinden otomatik kazıma
- Her işletme için arka plan araştırması
- Google Sheets'i gerçek zamanlı günceller
┌──────────────────────────────────────────────────────────┐
│ AŞAMA 1: VERİ TOPLAMA │
├──────────────────────────────────────────────────────────┤
│ Chat Trigger → AI Agent → Serper API → Alt Workflow │
│ ↓ │
│ Google Sheets Kayıt │
└──────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────┐
│ AŞAMA 2: ZENGİNLEŞTİRME │
├──────────────────────────────────────────────────────────┤
│ Sheets Trigger → Perplexity AI → Email & Background │
│ ↓ │
│ Sheets Güncelleme │
└──────────────────────────────────────────────────────────┘
Siz: "Los Angeles'ta 100 diş kliniği için bilgi çıkar"
AI Ajanı: "Los Angeles'ta diş kliniklerini arayacağım. Başlıyorum..."
[Google Haritalar araması]
[Birden fazla sayfada 100+ sonuç buluyor]
[Google Sheets'e otomatik kaydediyor]
AI Ajanı: "✅ 97 diş kliniği buldum ve sayfanıza kaydettim!"
[Arka plan işlemi otomatik başlar]
[Her potansiyel müşteriyi e-posta ve arka plan ile zenginleştirir]
[Sayfayı zenginleştirilmiş verilerle günceller]
| Kategori | Teknoloji | Amaç |
|---|---|---|
| Otomasyon | n8n | Workflow orkestrasyonu |
| AI Ajanı | OpenAI GPT-4o | Doğal dil anlama ve görev yürütme |
| AI Bellek | Buffer Window | Konuşma bağlamı saklama |
| Harita Arama | Serper.dev | İşletme verileri için Google Maps API |
| Zenginleştirme | Perplexity AI (Sonar) | E-posta bulma ve şirket araştırma |
| Depolama | Google Sheets | Potansiyel müşteri veritabanı |
| Servis | Gerekli mi? | Amaç | Maliyet |
|---|---|---|---|
| n8n | ✅ Evet | Workflow'ları çalıştır | Ücretsiz (self-hosted) veya $20/ay |
| OpenAI | ✅ Evet | GPT-4o AI ajanı | İstek başına ~$0.01-0.03 |
| Serper.dev | ✅ Evet | Google Haritalar araması | 5,000 arama için $50/ay |
| Perplexity AI | ✅ Evet | E-posta zenginleştirme | $20/ay veya kullanım başına |
| Google Hesabı | ✅ Evet | Google Sheets depolama | Ücretsiz |
⚠️ ÖNEMLİ: Bu sistem 2 ayrı workflow'dan oluşur. İkisi de ayrı ayrı import edilmeli ve birbirine bağlanmalıdır!
| Dosya | Tür | Açıklama |
|---|---|---|
Google map ai agent.json |
Ana Workflow | Chat arayüzü ve AI ajanı |
Gooogle map lead ai agent.json |
Alt Workflow | Veri kaydetme ve UUID oluşturma |
🔴 SIRA ÖNEMLİ! Alt workflow ÖNCE import edilmeli!
- n8n'i açın
- "Workflows" → "Import from File" tıklayın
Gooogle map lead ai agent.jsonseçin- "Import" tıklayın
- ✅ Import edildikten sonra workflow ID'sini not edin:
- URL'de görünür:
https://your-n8n.com/workflow/WORKFLOW_ID
- URL'de görünür:
- "Workflows" → "Import from File" tıklayın
Google map ai agent.jsonseçin- "Import" tıklayın
🔗 Ana workflow, alt workflow'u çağırabilmesi için bağlanmalı!
- Ana workflow'u açın
- "Call n8n Workflow Tool" node'unu bulun
- Node'a tıklayın
- "Workflow" alanında:
- Dropdown'dan "💥 xCodeWraith - Google Maps Lead Alt-Workflow" seçin
- https://sheets.google.com/ adresine gidin
- Yeni elektronik tablo oluşturun: "Leads Google map ai agent"
-
- satırda başlıklar oluşturun:
UUID | Name | Address | Number | Website | Rating | Opening Hours | Email | Background
Her iki workflow'da da Google Sheets node'larını güncelleyin:
Ana Workflow'da:
Google Sheets Triggernode → Spreadsheet ID'nizi seçinGoogle Sheets(update) node → Spreadsheet ID'nizi seçin
Alt Workflow'da:
Append row in sheetnode → Spreadsheet ID'nizi seçin
- Ana workflow'u açın → "Active" toggle'ını açın (yeşil)
- Alt workflow pasif kalabilir (ana tarafından otomatik çağrılır)
- Ana workflow'daki "When chat message received" node'una tıklayın
- "Production URL" kopyalayın
- Bu URL'yi tarayıcıda açarak chat arayüzüne erişin!
Node: "OpenAI Chat Model"
- https://platform.openai.com/api-keys adresinden API anahtarı alın
- n8n'de: Settings → Credentials
- "OpenAi account" kimlik bilgisi ekleyin
- API anahtarını yapıştırın
Node: "Map Search Tool"
- https://serper.dev/ adresinden kayıt olun
- Dashboard'dan API anahtarı alın
- Node'da Headers bölümünü bulun
X-API-KEYdeğerini anahtarınızla güncelleyin
Node: "Message a model1"
- https://www.perplexity.ai/settings/api adresinden API anahtarı alın
- n8n'de: Settings → Credentials
- "Perplexity account" kimlik bilgisi ekleyin
- n8n'de: Settings → Credentials
- "Google Sheets OAuth2 API" ekleyin
- OAuth akışını takip edin
Siz: "Seattle'da 50 kahve dükkanı bul"
AI: ✅ 47 kahve dükkanı buldum ve kaydettim!
Siz: "Los Angeles'ta 100 diş kliniği için bilgi çıkar"
AI: Los Angeles'ta diş kliniklerini arıyorum...
100 sonuç = 5 sayfa taranacak
✅ 97 diş kliniği kaydedildi!
| Alan | Açıklama | Kaynak |
|---|---|---|
| UUID | Benzersiz tanımlayıcı | Otomatik oluşturulur |
| Name | İşletme adı | Google Maps |
| Address | Tam adres | Google Maps |
| Number | Telefon numarası | Google Maps |
| Website | Şirket web sitesi | Google Maps |
| Rating | Google puanı | Google Maps |
| Opening Hours | Çalışma saatleri | Google Maps |
| İletişim e-postası | Perplexity AI | |
| Background | Şirket açıklaması | Perplexity AI |
| Sorun | Çözüm |
|---|---|
| Sohbet arayüzü yüklenmiyor | Ana workflow'un Aktif olduğunu doğrulayın |
| Harita aramasından sonuç yok | Serper.dev API anahtarını kontrol edin |
| Veriler Sheets'e kaydedilmiyor | Google Sheets credential'larını doğrulayın |
| Alt workflow çalışmıyor | Workflow bağlantısını kontrol edin |
| Metrik | Değer |
|---|---|
| Arama Hızı | 2 saniyede sayfa başına 20 sonuç |
| Kazıma | ~1 dakikada 100 potansiyel müşteri |
| Zenginleştirme | ~5-10 dakikada 60 potansiyel müşteri |
| Doğruluk | %90+ veri doğruluğu |
| Günlük Kapasite | 5,000-10,000 potansiyel müşteri |
Bu proje MIT Lisansı altında lisanslanmıştır.
✅ Ticari kullanım izni
✅ Değişiklik izni
✅ Dağıtım izni
✅ Özel kullanım izni
💥 xCodeWraith tarafından ❤️ ile yapıldı
⭐ Potansiyel müşteri oluşturmanıza yardımcı oluyorsa bu repoyu yıldızlayın!
Binlerce potansiyel müşteri oluşturmaya hazır mısınız? Şimdi AI ajanınızla sohbet etmeye başlayın! 🗺️