Harv3st

Google Maps lead scraper with professional dashboard.

Features

• Data Extraction: Name, rating, phone, website, address, hours, photos
• Lead Scoring: Rule-based scoring to prioritize prospects (no website = high score)
• Batch Mode: Run multiple queries sequentially
• Filters: By rating, website, search term
• CSV Export: One-click download
• Multi-language: English / Español

Quick Start

# Option 1: Double-click
run_dashboard.bat

# Option 2: Command line
python manager.py server

Open http://localhost:5050

API

Endpoint	Method	Description
/api/search	POST	Start scraping {"query": "..."}
/api/data	GET	Get all leads
/api/data/scored	GET	Get leads sorted by score
/api/export/csv	GET	Download CSV
/api/campaign	POST	Batch queries {"queries": [...]}

Requirements

• Python 3.8+
• Playwright (python -m playwright install chromium)

Install

pip install -r requirements.txt
python -m playwright install chromium

Project Structure

map-scraper-dashboard/
├── app/
│   ├── main_server.py    # Flask API
│   └── scraper.py        # Playwright scraper
├── core/
│   ├── parser.py         # Data extraction
│   ├── scoring.py        # Lead scoring
│   └── campaign.py       # Batch mode
├── templates/
│   └── dashboard.html    # UI
├── data/
│   └── leads.json        # Stored data
├── config.py
├── manager.py            # Entry point
└── requirements.txt

Themes

• ✅ Gradient Mesh (active)
• ⏳ Cyberpunk Neon
• ⏳ Scandinavian Minimal

License

MIT