Maps Lead Scraper

A lightweight Chrome extension that scrapes business leads directly from Google Maps search results.

Features

• 🔍 Manual Scraping - Extract business information from Google Maps results with one click
• 📊 CSV Export - Download scraped data in CSV format
• 💾 Accumulate Leads - Store multiple scraping sessions and export them together
• 📁 Batch Management - Organize scraped data by batch codes and dates
• 🗑️ Storage Control - Clear accumulated leads anytime

What Gets Scraped

Each business listing captures:

• Business name
• Category/Type
• Phone number
• Website
• Address
• Google Maps URL
• Rating
• Coordinates (latitude & longitude)
• Date scraped
• Batch code for organization

Installation

1. Clone or download this repository
2. Open Chrome and navigate to chrome://extensions/
3. Enable Developer mode (top right toggle)
4. Click Load unpacked
5. Select the project folder
6. The extension icon will appear in your Chrome toolbar

How to Use

Basic Scraping

1. Navigate to a Google Maps search page (e.g., restaurants, plumbers, etc.)
2. Click the Maps Lead Scraper extension icon
3. Click Scrape Current to extract all visible results
4. Click Download Current to save as CSV

Accumulate & Export

1. Perform multiple scrapes across different searches/pages
2. Click Append to Storage after each scrape to accumulate results
3. Click Export All to File to download all accumulated leads as one CSV
4. Files are saved to /Downloads/leads/ directory

Managing Data

• Clear Current - Remove current session's results from memory
• Clear Storage - Wipe all accumulated leads from storage

File Format

Exported CSV includes these columns:

address, category, latitude, longitude, maps_url, name, phone, rating, website, date_scraped, batch_code, source

Technical Details

• Manifest Version: 3 (MV3)
• Permissions: Active tab, tabs, scripting, storage, downloads
• Compatible: Google Maps search pages
• Storage: Uses Chrome's local storage API

Notes

• The extension only works on Google Maps pages
• Results show in the popup with a count
• Each scraping session gets a unique batch code for tracking
• Phone numbers are normalized (digits only)
• Data is stored locally in your browser

License

Open source - feel free to modify and distribute