Skip to content

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.

1.9 KB
Raw Blame
# 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: