Merhaba,
Kendi saha satış / lead çalışmalarım için geliştirdiğim, sonra ihtiyaçlar doğrultusunda epeyce genişlettiğim Harita Scraper Pro adlı Windows masaüstü programını paylaşmak istiyorum.
Program nedir?
Google Maps üzerindeki herkese açık işletme bilgilerini il/ilçe ve sektör bazında toplayan, işletmelerin web sitelerinden e-posta adresi bulan, sonuçları Excel/CSV'ye aktaran ve seçilen işletmelere WhatsApp Web (QR) veya Gmail / kendi domaininizin SMTP sunucusu üzerinden mesaj göndermenizi sağlayan tek pencereli bir uygulama.
Kısaca: "Haritadan lead çıkar → e-postasını bul → Excel'e al → mesaj at → takip et" zincirinin tamamı tek programda.
Ne işe yarar?
- Belirli bir il/ilçedeki belirli sektörleri (restoran, kuaför, diş kliniği, emlakçı vb.) listelemek
- Bu işletmelerin telefon, adres, puan, yorum, çalışma saati ve web sitesi bilgilerini toplamak
- Web sitesi olanların iletişim sayfalarından e-posta adreslerini çıkarmak
- Listeyi filtreleyip Excel'e dökmek
- Mini CRM ile aradığınız/görüştüğünüz firmaları takip etmek
- Uygun olanlara WhatsApp veya e-posta ile ulaşmak
Öne çıkan özellikler
1) Veri toplama
- 81 il listesi + isteğe bağlı ilçe; "Tüm Türkiye" seçeneği
- Hazır sektör kısayolları, virgülle çoklu sektör (restoran, kafe) veya her satıra bir özel sorgu
- İki mod: Hızlı (liste görünümü, çok hızlı) ve Detaylı (her işletmeyi açar; telefon, adres, saatler, puan gelir)
- Toplanan alanlar: işletme adı, kategori, telefon, adres, ilçe, il, puan, yorum sayısı, çalışma saatleri, Google Maps linki, web sitesi, e-postalar
- Sonuç limiti (0–5000), istekler arası bekleme, tarayıcıyı görünür/arkaplanda çalıştırma
- Telefonsuz kayıtları atlama, e-posta toplamayı açıp kapatma
- Aynı işletmenin tekrar eklenmesini engelleyen akıllı tekrar kontrolü (place ID / telefon / ad+adres)
2) E-posta bulucu
- İşletmenin sitesini ve iletişim/hakkımızda sayfalarını tarar
- mailto: bağlantıları ve sayfa metnindeki adresleri toplar
- Cloudflare ile gizlenmiş e-postaları çözebilir
- İşletmeye ait olmayan ajans/reklam adreslerini ayıklar, alan adına göre sıralar
- Sayfa sayısı ve zaman aşımı ayarlanabilir
3) Excel / CSV çıktısı
- Biçimlendirilmiş İşletmeler sayfası: başlık bandı, otomatik filtre, sabit başlık, tıklanabilir web sitesi ve Maps linkleri, 21 sütun
- Ayrı Özet sayfası: il/ilçe, sorgular, toplam kayıt, telefonlu/e-postalı sayıları, kategori dağılımı
- CSV çıktısı ; ayraçlı ve UTF-8 BOM'lu — Türkçe Excel'de doğrudan açılır
- Mevcut Excel/CSV listelerinizi programa geri aktarma (başlık satırını otomatik tanır)
4) Sonuç yönetimi
- Metin, kategori, telefon/e-posta/web sitesi, durum ve "takibi gelenler" filtreleri
- Toplu seçim: tümü, filtrelenenler, telefonu olanlar, e-postası olanlar
- Excel'e Aktar her zaman o an görünen (filtrelenmiş) kayıtları aktarır
- Kara liste: telefon, e-posta veya @alanadi.com bazında engelleme; gönderimlerde otomatik atlanır
5) Mini CRM
- Durumlar: Yeni, İletişimde, Görüşme, Teklif, Müşteri, Reddetti
- Her kayda not ve takip tarihi ekleme, toplu durum atama
- Takip tarihi gelenleri panelde ve sonuçlarda görme
- Durum/not/takip bilgileri Excel'e de yazılıyor
6) WhatsApp Web (QR)
- Telefonla QR okutup bağlanma; oturum bilgisayarda saklanıyor
- Arka plan modu: hiçbir WhatsApp/tarayıcı penceresi açılmadan gönderim (QR programın kendi penceresinde gösteriliyor)
- {isim}, {kategori}, {il}, {ilce}, {adres}, {telefon}, {site} alanlarıyla kişiselleştirme
- Şablon kaydetme, önizleme, kendine test gönderme
- Yalnızca geçerli mobil numaralar; istenirse sabit hatları da deneme
- Güvenlik: günlük/saatlik/gönderim başı limit, 30–75 sn rastgele bekleme, son 7 günde aynı numaraya tekrar göndermeme, "WhatsApp'ta yok" işaretleme, hesap uyarısında otomatik durma, istendiği an durdurma
- Sayaçlar veritabanında tutulur; program kapatılıp açılınca limit sıfırlanmaz
7) E-posta gönderimi
- Gmail (16 haneli uygulama şifresi) veya özel domain / SMTP (cPanel, Yandex, Outlook/Office365, Google Workspace)
- SSL/TLS (465) ve STARTTLS (587) desteği, bağlantı testi, test gönderimi
- Konu + mesaj + imza; aynı {isim} gibi alanlar burada da çalışıyor
- Günlük/saatlik/gönderim başı limit, 15–35 sn bekleme, son 7 günde gönderileni atlama, kota/hesap hatasında otomatik durma
- Şifreler Windows DPAPI ile şifrelenerek saklanıyor; config.json içinde düz metin yok. "Şifreyi sakla" kapatılırsa diske hiç yazılmıyor
8) Genel bakış paneli ve altyapı
- Toplam/telefonlu/e-postalı kayıtlar, bugünkü ve toplam gönderimler, kara liste, takip sayıları
- Kategori dağılımı, satış durumu, yaklaşan takipler, son gönderimler, son taramalar
- Yerel SQLite veritabanı (%LOCALAPPDATA%HaritaScraperProharita.db); açılışta son 2.000 kayıt geri yükleniyor
- Günde bir otomatik yedek, son 7 yedek saklanıyor; elle yedekleme ve veritabanını temizleme
- Tamamen Türkçe, koyu arayüz, yüksek DPI uyumlu
- Kısayollar: Ctrl+Enter tara, Ctrl+E Excel'e aktar, Ctrl+F ara, Ctrl+1…6 sayfa geçişi
- Hata günlüğü: %LOCALAPPDATA%HaritaScraperProerror.log
Teknik taraf
- Python 3.10+ / PySide6 (Qt) arayüz
- Playwright + Chromium ile tarama ve WhatsApp otomasyonu
- openpyxl ile Excel, SQLite ile yerel veri
- build_exe.bat ile PyInstaller paketi alınabiliyor (distHarita Scraper Pro...exe)
- Tüm veriler bilgisayarda kalıyor; harici bir sunucuya gönderilmiyor
Kimler için uygun?
Saha satış ekipleri, dijital ajanslar, yerel işletmelere hizmet veren freelancer'lar, emlak/danışmanlık, klinik/kuaför/restoran gibi sektörlere hizmet satanlar ve kendi müşteri listesini çıkarmak isteyenler.
Önemli notlar
- Program yalnızca herkese açık işletme bilgilerini toplar; kişisel veri toplamak için KVKK kapsamında hukuki dayanağınızın olması gerekir.
- WhatsApp Web otomasyonu resmî bir WhatsApp özelliği değildir ve Hizmet Şartları'na aykırıdır; kısa sürede çok mesaj atmak numaranın kısıtlanmasına yol açabilir. Ticari/yüksek hacimli gönderim için WhatsApp Business Platform (Cloud API) kullanılmalı.
- Ticari e-posta/WhatsApp gönderimlerinde ETK / İYS kurallarına ve alıcı onayına uymak kullanıcının sorumluluğunda.
- Google ve Gmail Hizmet Şartları'na uyulması gerekir.
Ekran görüntüleri ve kurulum/EXE dosyaları hazır. İlgilenenler yorumda belirtirse detayları, kurulum adımlarını ve ekran görüntülerini paylaşabilirim. Soru ve önerilere açığım.
================================================== ==================
HARITA SCRAPER PRO v1.3.0 - KURULUM KILAVUZU
Gelistirici: Maras Web Tasarim - www.maraswebtasarim.com.tr
================================================== ==================
1) GEREKSINIMLER
--------------------------------------------------------------------
- Windows 10 / 11 (64-bit)
- Python 3.10 - 3.12 (3.12 onerilir)
- Internet baglantisi (ilk kurulumda ~250 MB Chromium indirilir)
- En az 2 GB bos disk alani
2) HIZLI KURULUM (Python ile - onerilen)
--------------------------------------------------------------------
1. Zip dosyasini bir klasore cikarin.
Oneri: C:HaritaScraperPro
(Turkce karakter ve bosluk olmayan yol kullanin.)
2. Python kurun: https://www.python.org/downloads/
- Kurulum ekraninda "Add python.exe to PATH" secenegini isaretleyin.
- Kurulumdan sonra komut isteminde kontrol edin:
python --version
3. Klasordeki setup.bat dosyasina cift tiklayin.
Bu dosya:
- Gerekli Python paketlerini kurar
- Chromium tarayicisini indirir (~250 MB)
"Kurulum tamamlandi" yazisini gordugunuzde islem bitmistir.
4. run.bat dosyasina cift tiklayin. Program acilir.
Elle kurulum (komut istemi):
python -m pip install -r requirements.txt
python -m playwright install chromium
python main.py
3) ILK CALISTIRMA
--------------------------------------------------------------------
- Il secin, sektor yazin ve "ARAMAYI BASLAT" dugmesine basin.
- Detayli mod: telefon, adres, puan, saatler ve e-posta getirir.
- Hizli mod: sadece liste gorunumu; cok daha hizlidir, telefon gelmez.
- Sonuclar sekmesinden Excel'e veya CSV'ye aktarabilirsiniz.
- WhatsApp: "QR ile Baglan" -> telefonunuzdan QR kodu okutun.
- E-posta: Gmail uygulama sifresi veya kendi SMTP bilgilerinizle gonderin.
4) EXE OLUSTURMA (istege bagli)
--------------------------------------------------------------------
- build_exe.bat dosyasini calistirin.
- Cikti: distHarita Scraper ProHarita Scraper Pro.exe
- distHarita Scraper Pro klasorunun TAMAMINI kopyalayin.
Sadece .exe dosyasini kopyalamak calismaz; _internal klasoru gereklidir.
- EXE imzasiz oldugu icin bazi bilgisayarlarda Smart App Control
engelleyebilir. Bu durumda run.bat veya "python main.py" kullanin.
5) VERI KONUMU
--------------------------------------------------------------------
- Veritabani ve ayarlar: %LOCALAPPDATA%HaritaScraperPro
- Dosyalar: harita.db, config.json, backups, error.log
- Bu klasoru baskalariyla PAYLASMAYIN; kisisel veri ve gonderim
gecmisi icerir.
6) SORUN GIDERME
--------------------------------------------------------------------
- "python bulunamadi":
Python PATH'e eklenmemis. Yeniden kurup "Add to PATH" isaretleyin
veya "py -3 main.py" komutunu deneyin.
- "Tarayici bileseni (Chromium) bulunamadi":
setup.bat calistirin veya programdaki "Chromium'u indir/kur"
dugmesini kullanin.
- Program acilmiyor:
Komut isteminde "python main.py" calistirip hata mesajini gorun.
- Excel hatasi:
python -m pip install --upgrade openpyxl
- WhatsApp QR kodu gorunmuyor:
Internet baglantisini ve telefonunuzun saatini kontrol edin.
"Baglantiyi Kes" -> "QR ile Baglan" ile yeniden deneyin.
- Gmail "kimlik dogrulamasi basarisiz":
Normal Gmail sifresi calismaz. 2 Adimli Dogrulama acikken
olusturulan 16 haneli Uygulama Sifresi gerekir.
- Hata gunlugu:
%LOCALAPPDATA%HaritaScraperProerror.log
7) GELISTIRICI
--------------------------------------------------------------------
Maras Web Tasarim
www.maraswebtasarim.com.tr
Not: Bu program yalnizca herkese acik isletme bilgilerini toplar.
Kullanimda Google/WhatsApp/Gmail Hizmet Sartlari'na, KVKK'ya ve
ETK/IYS kurallarina uymak kullanici sorumlulugundadir.
================================================== ==================
İNDİRMEK İÇİN: https://disk.yandex.com.tr/d/oAdY2lcQAL6Bmg
