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.

docs(setup): troubleshoot the three things that actually blocked a fresh run (#4)

Ranshoshan2c6852217f21
diff --git a/SETUP.md b/SETUP.md
index 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.
---