leadmaps 1.0.1

Apollo-class local lead generation from Google Maps — no API. Streams leads to Notion, Google Sheets, CSV, Excel or PDF with live progress and zero duplicates.

leadmaps 🗺️ → 📇

Apollo-class local lead generation from Google Maps. No API. Streams leads straight into Notion or CSV — with live progress and zero duplicates.

Ships in two interchangeable editions with the same CLI and the same 41-field Apollo-grade output:

Edition	Best for	Install
🐍 Python (src/leadmaps)	you have Python; + Google Sheets & scripting	pipx install leadmaps
🐹 Go (go/)	no Python — one self-contained binary	download the binary, run it

Pick whichever fits the machine — same leadmaps commands, same keyless connect. Python adds the Google Sheets connector; the Go binary needs nothing installed but Chrome.

Better than Apollo for local SMBs: phone, website, socials, geo-coordinates, Google Place ID, rating, reviews, hours, photos, Lead Score — and a no-website filter to find your prime prospects. Apollo has none of that for a neighbourhood business.

---

🔌 Connect Notion in one click — no keys, ever

You never paste keys into .env. The first time you send leads to Notion, your browser opens, you authorize once, and the token is cached only on your computer (~/.leadmaps/credentials.json). Every run after that is silent.

leadmaps connect notion          # opens the browser, authorize once → done
# or just run — it auto-connects the first time:
leadmaps run --niche "cafe" --location "Kolkata" --limit 30 --to notion

Google Sheets is even simpler — there is no Google sign-in at all. Leadmaps writes as its own service account, so instead of asking Google for permission on your behalf, you share your own sheet with it:

leadmaps connect google          # prints an address — share your sheet with it
leadmaps run --niche "cafe" --location "Kolkata" --limit 30 --to gsheets

Open your sheet → Share → paste the address → Editor → Send, then paste the sheet link back. Leadmaps can write to that one spreadsheet and nothing else in your Drive. You never type a Google password anywhere.

Disconnect any time:

leadmaps disconnect notion       # removes the local Notion token

For Google Sheets, just remove the Leadmaps address from the sheet's Share dialog — access ends immediately. Buyer setup (dead simple, both editions): lemonsqueezy/SETUP.md. How the keyless connect stays secure (auth broker): DEPLOYMENT.md.

🐍 Python edition — use pipx (not pip)

Why not pip install? On modern Linux/macOS it's blocked (externally-managed-environment), and on Windows it installs leadmaps to a folder that's not on your PATH (so leadmaps "is not recognized"). pipx fixes both — it's the right tool for installing CLI apps.

1. Install pipx once (per OS):

# Windows  (then CLOSE and reopen the terminal)
py -m pip install --user pipx
py -m pipx ensurepath
# macOS
brew install pipx && pipx ensurepath
# Linux (Debian/Ubuntu/Mint)
sudo apt install -y pipx && pipx ensurepath

2. Install and run — the browser downloads itself on first run, no extra step:

pipx install leadmaps
leadmaps connect notion             # browser opens → authorize once → done
leadmaps run --niche "cafe" --location "Kolkata" --limit 30 --to notion

• leadmaps not found? Reopen the terminal, or run everything as python -m leadmaps … (e.g. python -m leadmaps run …) — needs no PATH, always works. • Got an old version? pipx upgrade leadmaps (latest is 1.0.0). • Already used pip? pip uninstall leadmaps, then use pipx.

Connectors: Notion, Google Sheets, CSV, XLSX, PDF.

🐹 Go edition — single binary, zero Python, zero pip

The no-hassle path. In your download, open bin/ and pick your OS:

# macOS / Linux
chmod +x leadmaps && sudo mv leadmaps /usr/local/bin/
# Windows: run leadmaps.exe (optionally move it to a folder on your PATH)

leadmaps connect notion             # one-time browser authorize (no .env)
leadmaps run --niche "cafe" --location "Kolkata" --limit 30 --to notion

Needs only Google Chrome — nothing else to install. Same leadmaps commands as the Python edition.

---

Same CLI, both editions

leadmaps run --niche "<type>" --location "<city>" --limit <N> --to notion --website without
leadmaps doctor        # internet, connectors, browser
leadmaps fields        # the 41-field Apollo-grade schema

  [██████████░░░░░░] 21/30 leads (70%) │ #54 of 110 scanned │ ETA 1m20s │ Blue Tokai

Let AI run it

Ships a skill file for assistants that can run commands on your machine (Claude Code, Cursor). Drop in skills/leadmaps/SKILL.md and just ask: "pull 15 gyms in Mumbai without a website into Notion". The agent runs the real CLI, reads the --json event stream, and reports honestly.

MCP connector — beta soon. A hosted MCP connector, so browser AIs like claude.ai and ChatGPT can drive leadmaps without a terminal, is in development and opens in beta soon.

Docs

• lemonsqueezy/SETUP.md — buyer setup, both editions, dead simple.
• DEPLOYMENT.md — the Cloudflare Worker: site, auth broker and licensing.
• skills/leadmaps/SKILL.md — the agent operating manual.
• TESTS.md — real runs with captured output.

Built by Auradevs.