leadgen-maps 1.1.2

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

leadgen 🗺️ → 📇

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/leadgen)	you have Python; + Google Sheets & scripting	pipx install leadgen-maps
🐹 Go (go/)	no Python — one self-contained binary	download the binary, run it

Pick whichever fits the machine — same leadgen 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 (~/.leadgen/credentials.json). Every run after that is silent.

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

Google Sheets is the same — leadgen connect google opens the browser, you click Allow, and we auto-create a Sheet in your Drive:

leadgen connect google
leadgen run --niche "cafe" --location "Kolkata" --limit 30 --to gsheets

Switch accounts or log out any time:

leadgen disconnect notion | google | all     # removes the local token

Buyer setup (dead simple, both editions): lemonsqueezy/SETUP.md. How the keyless connect stays secure (auth broker): broker/README.md.

🐍 Python edition

pipx install leadgen-maps          # public on PyPI — repo stays private
python -m playwright install chromium
leadgen connect notion             # one-time browser authorize (no .env)
leadgen run --niche "cafe" --location "Kolkata" --limit 30 --to notion

Connectors: Notion, Google Sheets, CSV, XLSX, PDF. Hosting + email on completion in deploy/.

🐹 Go edition (single binary — no Python)

Download the binary for your OS (from the release / your product download), then:

# macOS / Linux
chmod +x leadgen && sudo mv leadgen /usr/local/bin/
# Windows: just run leadgen.exe (optionally add it to PATH)

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

Connectors: Notion, Google Sheets, CSV, XLSX, PDF. Drives your installed Chrome. (Developers with Go: go install github.com/subhadeeproy3902/lead-gen/go/cmd/leadgen@latest.)

---

Same CLI, both editions

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

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

Let AI run it (Claude Code AND claude.ai)

Ships an async MCP server so any MCP-capable AI can call leadgen as a tool. A scrape takes minutes, so leadgen_run starts a background job and returns an ETA instantly; leadgen_status fetches the leads when ready. One job per user.

• Claude Code / Cursor (local) — add lemonsqueezy/mcp/leadgen.mcp.json; just ask "pull 15 gyms in Mumbai".
• claude.ai (website) — host it on a VPS and add the HTTPS URL + /mcp as a custom connector.

Docs

• lemonsqueezy/SETUP.md — buyer setup, both editions, dead simple.
• lemonsqueezy/mcp/MCP-SETUP.md — use it from an AI assistant.
• deploy/MCP-VPS-SETUP.md — host the async MCP server on a VPS, 24/7.
• broker/README.md — the auth broker that keeps the OAuth secret off the package.
• skills/leadgen/SKILL.md — the agent operating manual.
• TESTS.md — real runs with captured output.

Built by Auradevs.