Mahanaicoach / google-maps-scraper-kit

# Google Maps Scraper Kit
 Last verified working: 2026-10-14 with engine v1.18.1 on macOS Apple Silicon. 
**A free, open-source Google Maps scraper for lead generation that runs on your own machine.**
Name a business type and a city. Get back an outreach-ready CSV with name, phone, email, website,
category, address, rating and review count. Add `--socials` for Instagram, Facebook and LinkedIn.
No Google Maps API key, no SaaS credits, no data leaving your computer. One Docker command starts the
engine. Then run it from the terminal, or let Claude Code, Codex or Cursor drive it for you in plain
English.
| Goal | Start here |
|---|---|
| Get a lead list in the next 5 minutes | Quick start |
| Let an AI coding agent run the scrape | Use it with Claude Code or any agent |
| Scrape many keywords or cities in one job | Batch jobs |
| Know what you get and where it stops | What you get and Honest limits |
| Compare it with Apify, Outscraper and chat AIs | How it compares |
| Follow a worked recipe for dentists, roofers or restaurants | Guides and recipes |
---
## Quick start
Requires Docker Desktop. Python 3 is optional and
uses the standard library only.
 [code] 
No coordinates handy? Let the Python CLI geocode the city:
 [code] 
Need the whole city, not just the first 120? Add `--grid 3`:
 [code] 
### Example output
`coffee_shops_austin.csv` (illustrative rows):
| title | phone | emails | website | category | address | review_rating | review_count |
|---|---|---|---|---|---|---|---|
| Example Roasters | +1 512-555-0101 | hello@example.com | example.com | Coffee shop | 100 Congress Ave, Austin, TX | 4.7 | 812 |
| Sample Espresso Bar | +1 512-555-0102 | info@example.org | example.org | Cafe | 200 S Lamar Blvd, Austin, TX | 4.5 | 356 |
`--socials` adds `instagram`, `facebook` and `linkedin` columns. `--full` keeps all ~34 raw fields,
including opening hours, coordinates, price range and reviews.
Full walkthrough, platform notes and troubleshooting: SETUP.md.
---
## Use it with Claude Code or any agent
The kit ships a Claude Code skill that teaches the
agent the exact job API, the required fields, polling, CSV cleanup and the rate-limit guardrails.
It also works with Codex, Cursor and any other Agent Skills-compatible tool.
**Option A: open the folder in Claude Code.** The skill and four slash commands load automatically.
 [code] 
**Option B: install the skill into an agent you already use.**
 [code] 
Then ask in plain language:
> Scrape gyms in Miami and give me phones, emails and websites.
The agent checks the engine is up and starts it if not, builds the job, polls in the background,
downloads the CSV, keeps the 8 lead fields, and hands you a clean table plus the file.
| Slash command (Claude Code) | Action |
|---|---|
| `/scrape in [depth]` | Run one scrape, return a clean table and CSV |
| `/scrape-batch [--city "City, ST"]` | Run many queries as one job |
| `/scrape-setup` | Start the engine and run a health check |
| `/scrape-jobs [list \| delete ]`