Google Maps Business Scraper (v3 - Professional)

Bu proje, Google Maps üzerindeki işletmeleri aratarak hedef kitlelerin iletişim bilgilerini (İsim, Kategori, Adres, Telefon, E-posta, Sosyal Medya, WhatsApp, Koordinatlar vb.) toplu bir şekilde toplayan ve Excel dosyasına aktaran profesyonel bir veri kazıma (scraping) aracıdır.

---

🚀 Öne Çıkan Özellikler (Features)

🔹 Google Maps Veri Çıkarımı

• Toplu Arama (Bulk Search): Birden fazla arama terimini satır satır girerek ardışık tarama yapabilme.
• Detaylı Bilgi Çıkarımı: İşletme Adı, Kategori, Adres, Telefon Numarası (farklı tüm formatlar desteklenir), Puanlama ve Yorum Sayısı.
• 📍 Coğrafi Koordinatlar: İşletmelerin harita üzerindeki tam enlem (latitude) ve boylam (longitude) konum bilgileri.
• ⏰ Çalışma Saatleri & Durum: İşletmenin haftalık çalışma saatleri (working_hours) ve anlık açık/kapalı durumu (current_status).

🔹 Web Sitesi Derin Tarama (Deep Crawling)

• 🔐 Cloudflare E-posta Şifre Çözücü: Web sitelerinin spam engellemek için Cloudflare (__cf_email__) arkasına gizlediği şifreli e-postaları çözebilen özel algoritma.
• 🟢 WhatsApp & Telegram Tespiti: Web sitelerindeki doğrudan sohbet/iletişim bağlantılarını (wa.me, api.whatsapp.com, t.me) tarayarak doğrudan numara ve kanalları Excel'e aktarma.
• 📱 Sosyal Medya Linkleri: Sitedeki Instagram, Facebook, LinkedIn, Twitter/X ve YouTube adreslerini otomatik bulma.
• 📧 İletişim Sayfası Taraması: E-posta adreslerini bulmak için ana sayfa dışında "İletişim", "Hakkımızda" gibi sayfaları da tarayan akıllı mekanizma.

🔹 Gelişmiş Entegrasyon ve Kontroller

• 🌐 Proxy Desteği: IP engellemelerini aşmak için opsiyonel proxy yapılandırması.
• 🕶️ Headless Modu: Arka planda çalışabilmesi için tarayıcı penceresini gizleyebilme seçeneği.
• 📊 Canlı Takip & Progress: Arayüz üzerinden anlık işlem logları ve ilerleme çubuğu (progress bar).
• 📥 Dinamik Kaydetme: Toplanan verileri doğrudan proje dizininde temiz bir Excel (.xlsx) dosyası olarak kaydetme.

---

🛠️ Nasıl Çalıştırılır (How to Run)

Projeyi çalıştırmak için öncelikle terminalinizde projenin bulunduğu klasöre gidin:

Yöntem 1: Görsel Arayüz (Masaüstü Uygulaması) - Önerilen

Aşağıdaki komutla modern Tkinter arayüzünü başlatabilirsiniz:

python gui_app.py

• Arama Terimleri: Kutuya her satıra bir arama terimi gelecek şekilde yazın.
  • Örnek:

    Kadikoy Cafeler
    Besiktas Spor Salonlari
    Sisli Restoranlar
    

• Limit: Her arama terimi için kaç adet işletme çekileceğini belirleyin.
• Başlat: Butona basarak tarama işlemini başlatın. Dosyalarınız otomatik olarak proje klasörüne kaydedilecektir.

Yöntem 2: Komut Satırı (Terminal)

Komut satırından hızlıca tarama yapmak için main.py dosyasını parametrelerle çalıştırabilirsiniz:

python main.py --search "Kadıköy Yazılım Şirketleri" --limit 20

Parametreler:

• --search: Aranacak terim.
• --limit: Çekilecek işletme sayısı (varsayılan: 10).
• --proxy: Opsiyonel proxy adresi (örn: http://user:pass@ip:port).
• --headless: Tarayıcı penceresini gizlemek için bu bayrağı ekleyin.
• --deep-crawl: Web sitelerinde daha derin ve yavaş sosyal medya araması yapmak için ekleyin.

---

📦 Kurulum (Installation)

Gerekli kütüphaneleri yüklemek için:

pip install -r requirements.txt
playwright install

---

Tip

Derin tarama (deep-crawl) seçeneği, her işletmenin web sitesini tek tek ziyaret ettiği için işlem süresini artırabilir. Çok yüksek limitli taramalarda (örn: 200+) internet hızınıza bağlı olarak tarayıcıyı gizleme (headless) modunu açmanız önerilir.