Metadata-Version: 2.4
Name: leadgen-maps
Version: 1.1.1
Summary: Apollo-class local lead generation from Google Maps — no API. Streams leads to Notion, Google Sheets, or CSV with live progress and zero duplicates.
Author: Auradevs
License: Proprietary
Project-URL: Homepage, https://github.com/subhadeeproy3902/lead-gen
Project-URL: Repository, https://github.com/subhadeeproy3902/lead-gen
Keywords: lead-generation,google-maps,scraper,notion,apollo,outreach,automation
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: playwright>=1.49
Requires-Dist: openpyxl>=3.1
Requires-Dist: fpdf2>=2.7
Provides-Extra: sheets
Requires-Dist: gspread>=6.0; extra == "sheets"
Requires-Dist: google-auth>=2.0; extra == "sheets"
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == "mcp"
Provides-Extra: all
Requires-Dist: gspread>=6.0; extra == "all"
Requires-Dist: google-auth>=2.0; extra == "all"
Requires-Dist: mcp>=1.0; extra == "all"

# 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.
```bash
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:
```bash
leadgen connect google
leadgen run --niche "cafe" --location "Kolkata" --limit 30 --to gsheets
```
Switch accounts or log out any time:
```bash
leadgen disconnect notion | google | all     # removes the local token
```
See **[CONNECT.md](CONNECT.md)** for the one-time OAuth setup (Notion + Google)
and uninstall steps.

## 🐍 Python edition
```bash
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/`](deploy/).

## 🐹 Go edition (single binary — no Python)
Download the binary for your OS (from the release / your product download), then:
```bash
# 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
```bash
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 **MCP server** so any MCP-capable AI can call leadgen as a tool:
- **Claude Code** — the included `.mcp.json` exposes it automatically; just ask "pull 15 gyms in Mumbai".
- **claude.ai (website)** — run `python -m leadgen_maps.mcp_server --http`, expose it with a free tunnel, add it as a custom connector → the website executes leadgen on your machine.

Exact steps: **[CONNECT-CLAUDE.md](CONNECT-CLAUDE.md)**. The plain CLI (`--json`
events) and the agent skill ([`skills/leadgen/SKILL.md`](skills/leadgen/SKILL.md))
also work.

## Docs
- **[CONNECT-CLAUDE.md](CONNECT-CLAUDE.md)** — let Claude Code + claude.ai run leadgen (MCP connector).
- **[deploy/HOSTING-VPS.md](deploy/HOSTING-VPS.md)** — host a public, multi-tenant MCP server on a free VPS (e.g. `leadgen.auradevs.co/mcp`).
- **[BUYER-GUIDE.md](BUYER-GUIDE.md)** — bought it? Dead-simple per-OS setup (Windows/Mac/Linux).
- **[DOCUMENTATION.md](DOCUMENTATION.md)** — full guide (install, connectors, fields, hosting, edge cases).
- **[DISTRIBUTION.md](DISTRIBUTION.md)** — install channels (release binary, `go install`, Homebrew, Scoop, winget).
- **[ABOUT.md](ABOUT.md)** — what it is and why · **[prompt.md](prompt.md)** — paste into ChatGPT to drive it.
- **[TESTS.md](TESTS.md)** — real runs with captured output + screenshots.

Built by Auradevs.
