Google Maps Scraper Kit

Finding a list of local businesses normally means copying one Google Maps result at a time or paying for a lead database. Google Maps Scraper Kit uses Docker Desktop, software that runs the scraper separately from your other apps, and gives Claude Code a saved skill for starting searches, waiting for results and saving spreadsheet files. It can also visit each business website to look for an email address. It is not an official Google tool. The repository says scraping Google Maps is against Google's terms, and Google may temporarily block your internet address if you run too much at once.

Use it for a small, focused list of public business details, such as finding nearby suppliers or building an outreach list you will check before contacting anyone. Start with one search at depth 5, which tells the scraper to scroll through a small number of result pages, because large or repeated jobs can be blocked. On Macs with M-series chips, the current scraper may run more slowly because it was built for a different processor. On Windows, use the included Python script rather than the shell script. Email collection visits the businesses' own websites and is enabled automatically after the first test unless you keep the `--no-email` option. Treat phone numbers and email addresses as personal data, use them only with a lawful reason and honour requests not to be contacted. Do not use the tool to collect information about individuals, send spam or bypass access controls. Follow the website's terms and the privacy and marketing laws that apply to your use.

1. Install Docker Desktop from docker.com/products/docker-desktop, Python 3 from python.org/downloads and Git from git-scm.com/downloads. Open the Terminal app, the window where you type commands, and run `docker --version`, `docker compose version`, `python3 --version` and `git --version`. On Windows, use `py --version` if `python3 --version` is not recognised. Open Docker Desktop and wait until it says the engine is running, then run `docker info`. Continue only if the version checks and `docker info` finish without an error.
2. Paste the command below to copy the repository into a fresh folder. Then run `cd google-maps-scraper-kit`, followed by `docker compose up -d`. Open `http://localhost:8080/api/v1/jobs` in your browser and continue only if it shows a JSON list, a line of structured text inside square brackets. The file named docker-compose.yml must keep `127.0.0.1:8080:8080`; this prevents the service, which has no login, from being opened to the public internet.
3. Run `python3 scripts/scrape.py "coffee shops" --city "Austin, TX" --depth 5 --no-email` for a small first test. On Windows, replace `python3` with `py` if that is the command that passed the version check. The place name goes to OpenStreetMap's Nominatim service to find its coordinates, then the scraper searches Google Maps and saves a spreadsheet file named `results-<job>.csv` in the project folder. Check a sample against the original listings. Remove `--no-email` only when you need public business emails and can handle that personal data lawfully. Run `docker compose down` when finished. Job data remains in the Docker storage volume; the project's SETUP guide shows how to delete one job, or you can run `docker compose down -v` instead when you intend to erase every saved scraper job.