Indra-cahya GitHub avatar

MScrape

Indra-cahya

MScrape is a Python and Streamlit-based tool for automatically scraping thousands of business leads from Google Maps with a user-friendly web interface.

Stars

8

7-day growth

No data

Forks

5

Open issues

0

License

No data

Last updated

2026-07-30

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines global/local scraping, intelligent geolocation, automated email extraction, and anti-detection mechanisms in a single no-code UI, making lead generation accessible to non-programmers.

Who it is for

  • B2B lead generation professionals
  • Marketing agencies
  • Small business owners seeking local leads
  • Sales teams doing cold outreach

Use cases

  • Finding potential cafe/restaurant clients in a specific city
  • Building a list of plumbers or dentists for a marketing campaign
  • Collecting emails from local business websites for cold outreach
  • Exporting curated business leads into Excel for CRM import

Strengths

  • Built-in email extraction from business websites
  • Configurable blacklist to filter out spam or large corporate emails
  • Geocoding via Nominatim for accurate location-based searches
  • Anti-click intercept design to resist Google Maps layout changes

Considerations

  • Performance depends on internet speed and RAM due to headless browser (Selenium)
  • Google Maps layout updates may break XPath selectors, requiring occasional maintenance
  • Ethical considerations: scraping may violate Google's ToS; user must respect privacy policies

README quick start

🚀 MScrape: Google Maps Scraper

Sebuah tool berbasis Python & Streamlit yang digunakan untuk mengambil (scrape) ribuan prospek/leads bisnis potensial dari Google Maps secara cepat dan otomatis. Didesain dengan antarmuka web (UI) agar mudah digunakan meski tanpa pengetahuan coding.

Alat ini cocok untuk B2B Lead Generation, agensi marketing, pencarian data restoran/kafe, dan cold outreach.

✨ Fitur Utama

  • 🌍 Scraping Global & Lokal: Cari bisnis di kota manapun berdasarkan niche/kata kunci.
  • 📍 Geolocation Cerdas: Mendukung ekstraksi titik otomatis (Geocoding via Nominatim) untuk hasil pencarian yang sangat akurat.
  • 🤖 Anti-Click Intercept & Tahan Banting: Dirancang agar tahan terhadap perubahan tata letak antarmuka Google Maps dengan metode pencarian XPath berbasis Aria-Label.
  • 📧 Ekstraksi Email Otomatis: Bot akan mencoba mengunjungi masing-masing website bisnis dan memindai halaman tersebut untuk mendapatkan alamat email resmi mereka.
  • 🛡️ Built-in Filter Blacklist: Mengabaikan email spam (seperti info@, noreply@) atau bisnis korporat besar (seperti Starbucks, KFC). Semuanya dapat dikonfigurasi melalui antarmuka.
  • 💾 Export to Excel: Hasil akhir bisa didownload langsung dalam format .xlsx dengan rapi.

🛠️ Persyaratan Sistem

  • Python 3.8 atau lebih baru
  • Google Chrome terinstal di komputer/server Anda

🚀 Instalasi & Cara Penggunaan

  1. Clone repositori ini:

    git clone https://github.com/Indra-cahya/MScrape.git
cd MScrape

  2. Instal dependensi Python: Pastikan Anda menjalankan perintah ini untuk menginstal semua library yang dibutuhkan.

    pip install -r requirements.txt

  3. Jalankan Aplikasi: Bagi pengguna Windows, Anda cukup klik dua kali pada file: run.bat

    Atau jalankan manual melalui terminal:

    cd GoogleMaps-Lead-Scraper
streamlit run app.py

  4. Buka di Browser: Aplikasi akan otomatis terbuka. Jika tidak, silakan kunjungi http://localhost:8501.

⚙️ Cara Pemakaian di Antarmuka

  1. Masukkan kata kunci (Niche) pada panel sebelah kiri (contoh: cafe, plumber, dentist).
  2. Tentukan asal Kota/Negara.
  3. Centang fitur Cari Email jika Anda juga membutuhkan alamat email mereka (Proses akan sedikit lebih lama).
  4. Tekan "Gas Scrape Sekarang! 🔥" dan tunggu hingga bar progres m

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482