# Maps Lead Gen

Find local businesses **without websites** on Google Maps.

## Setup

```bash
cd tools/maps-lead-gen
source venv/bin/activate
```

## Usage

```bash
# Basic search
python3 scrape.py --query "plumbers" --location "Austin TX"

# Specific limit
python3 scrape.py --query "restaurants" --location "Round Rock TX" --limit 30

# Save as JSON
python3 scrape.py -o leads.json --query "auto repair" --location "Cedar Park TX" --json

# See the browser window (for debugging)
python3 scrape.py --query "salons" --location "Austin TX" --visible
```

## Output

For each business without a website:
- **Name** — business name
- **Phone** — if listed (from tel: link or text extraction)
- **Rating** — star rating with review count
- **Address** — street address
- **Maps URL** — direct link to the Google Maps listing

## How it works

1. Opens headless Firefox with Playwright
2. Navigates to Google Maps search URL
3. Extracts all business listings from the search results
4. Filters out businesses that have a website link
5. Saves results to CSV/JSON

## Notes

- ~8-12 results per search (Google Maps initial load limit)
- No API keys, no accounts, no paid tiers — 100% free
- Uses Firefox in headless mode
- Consent cookies are auto-set to bypass Google prompts