Free, open-source Google Maps scraper for lead generation (Python, no API key, no Docker). Exports name, phone, email, website, rating and Instagram/Facebook/LinkedIn/TikTok/YouTube/X links to CSV. 100 places with emails in 44 s; --grid beats Google's 120 cap. MX email check, ad-pixel detection. Skill for Claude Code, Codex and Cursor.
Python agent-skillsb2b-leadsclaude-codeclaude-skillscodex-skillsemail-extractoremail-scrapergoogle-mapsgoogle-maps-extractorgoogle-maps-leadsgoogle-maps-scrapergoogle-maps-scraper-pythongoogle-maps-scrapinggooglemaps-scraperheadless-chromelead-generationlead-scraperno-api-keypythonweb-scraping
# Runs the kit's own Google Maps engine (engine/serve.py with Debian's Chromium, see Dockerfile).
# Serves the web UI and API on http://localhost:8080. Host port: SCRAPER_PORT in .env, default 8080.
# The port is published on 127.0.0.1 only, so other machines cannot reach it: that localhost binding
# is the security boundary. Inside the container the engine listens on 0.0.0.0 so Docker can forward
# to it, and refuses any request whose Host or Origin is not localhost. Do not change the mapping to
# 0.0.0.0 or a public interface.
# No Docker? `python3 scripts/engine.py start` runs the same engine directly on this machine.
services:
google-maps-scraper:
build: .
restart: unless-stopped
init: true # reaps Chromium's helper processes, which the engine would leave as zombies as PID 1
stop_grace_period: 20s # time for the engine to pause its job, so it resumes on the next start
depends_on: [ui] # kit 1.x's web front goes first, so the port is free (see ui below)
environment:
# Blank by default. When set in .env, the engine wants it as an X-API-Key header.
SCRAPER_API_KEY: ${SCRAPER_API_KEY:-}
ports:
# Host port comes from SCRAPER_PORT in .env (default 8080). The container side stays 8080.
- "127.0.0.1:${SCRAPER_PORT:-8080}:8080" # localhost only, see the warning above
volumes:
- engine_data:/kit/.engine/data # jobs and results, kept across restarts and rebuilds
# Kit 1.x's jobs and results, read-only: the engine imports them once, on its first start
# (engine/jobs.py import_kit1). On a new install this volume is empty.
- gmaps_data:/kit/.engine/kit1:ro
# Kit 1.x ran a web front (nginx) under this name, which holds the port. Zero copies here makes
# `docker compose up -d` remove it on the update from 1.x; nothing is downloaded or started.
ui:
image: nginx:1.27-alpine
pull_policy: never
deploy:
replicas: 0
volumes:
engine_data:
gmaps_data: