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
docs(setup): troubleshoot the three things that actually blocked a fresh run (#4)
Ranshoshan2c6852217f21
diff --git a/SETUP.md b/SETUP.mdindex 1a43dd8..92ce864 100644--- a/SETUP.md+++ b/SETUP.md@@ -173,6 +173,52 @@ curl -X DELETE http://localhost:8080/api/v1/jobs/<job-id>| Job stuck `working` forever | Lower `depth`, or the IP is being throttled by Google — wait, or add proxies (see skill). || Empty CSV | Keyword too narrow or wrong geo — widen `radius` or fix `lat`/`lon`. || Docker pull is slow | Normal on first run; it caches after that. |+| `docker: 'compose' is not a docker command` / `unknown shorthand flag: 'd'` | The Compose plugin is missing. It ships with Docker Desktop — uninstalling Desktop leaves a **dangling symlink** in `~/.docker/cli-plugins/` that looks installed but isn't (`ls -l ~/.docker/cli-plugins/docker-compose`). Install it (`brew install docker-compose`), or skip Compose entirely — see *No Compose?* below. |+| `no space left on device` while pulling | The **VM's** disk is full, not your Mac's — Colima/Lima/Docker Desktop each run a fixed-size virtual disk. Check with `docker system df`, reclaim with `docker image prune -a`, or grow the disk (Colima: `colima stop && colima start --disk 60`). The image bundles Chromium, so budget a few GB. |+| `could not install driver: … 404 … playwright.azureedge.net` | Only hits you when running the scraper **natively** (not in Docker) — the Docker image has the driver baked in. Playwright's old Azure CDN is retired; as of Sept 2026 the replacement hosts 400 too. Workaround under *Running without Docker* below. |+++### No Compose? Run the same container with `docker run`++`docker-compose.yml` is thin — this is the exact equivalent, localhost binding and all:++```bash+docker run -d --name gmaps-scraper --restart unless-stopped \+ -p 127.0.0.1:8080:8080 \+ -v gmaps_data:/gmapsdata -v gmaps_cache:/opt \+ gosom/google-maps-scraper:v1.15.0 -web -data-folder /gmapsdata+```++Add `--platform linux/amd64` on Apple Silicon. Stop it with `docker stop gmaps-scraper`.++### Running without Docker (fallback)++If Docker is unavailable — or the image's amd64 emulation is too slow on Apple Silicon — run the+scraper natively. It's a single Go binary, and it serves the **same API on the same port**, so every+script and slash command in this kit works unchanged.++```bash+go install github.com/gosom/[email protected]+google-maps-scraper -web -addr 127.0.0.1:8080 -data-folder ./gmapsdata+```++> Keep `-addr 127.0.0.1:8080`. The binary defaults to `:8080` — **all interfaces** — and the scraper+> has no authentication. In Docker the localhost binding comes from the port mapping; here it's on you.++**If the first job dies with `could not install driver: … 404`:** `playwright-go` fetches its driver+from `playwright.azureedge.net`, which Microsoft retired; the replacement hosts currently answer `400`+for driver zips (browser downloads still work). That driver is just the `playwright-core` npm package+plus a `node` binary, so you can assemble it by hand — match the version the error names:++```bash+V=1.57.0 # whatever version the error asks for+D=~/Library/Caches/ms-playwright-go/$V # Linux: ~/.cache/ms-playwright-go/$V+npm pack playwright-core@$V && tar xzf playwright-core-$V.tgz+mkdir -p "$D" && cp -R package "$D/package" && cp "$(command -v node)" "$D/node"+"$D/node" "$D/package/cli.js" --version # should print: Version <V>+```++Restart the scraper; it finds the driver, downloads Chromium normally, and runs.---