Google Maps Scraper

Turn a business type and a location into clean lead rows by driving the local engine's job API.

Mental model

The engine (gosom/google-maps-scraper) runs as a local Docker container with a REST API at http://localhost:8080. It has no auth, so it stays bound to localhost. A scrape is an async job: create it, poll until it is done, then download a CSV. One job can run many keywords. Each result has up to 34 raw fields.

Step 0: Check the engine is running

curl -s http://localhost:8080/api/v1/jobs >/dev/null 2>&1 && echo UP || echo DOWN

If DOWN: run docker compose up -d from the kit root, wait ~10s, and retry. If Docker is not installed, point the user to SETUP.md.