Metadata-Version: 2.4
Name: leadmaps
Version: 1.0.0
Summary: 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.
Author: Auradevs
License: Proprietary
Project-URL: Homepage, https://leadmaps.auradevs.co
Project-URL: Repository, https://github.com/AuraDevs7/leadmaps
Keywords: lead-generation,google-maps,scraper,notion,apollo,outreach,automation,cli
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: playwright>=1.49
Requires-Dist: openpyxl>=3.1
Requires-Dist: fpdf2>=2.7
Requires-Dist: rich>=13.7
Requires-Dist: prompt_toolkit>=3.0
Provides-Extra: sheets
Requires-Dist: gspread>=6.0; extra == "sheets"
Requires-Dist: google-auth>=2.0; extra == "sheets"
Provides-Extra: all
Requires-Dist: gspread>=6.0; extra == "all"
Requires-Dist: google-auth>=2.0; extra == "all"

# 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.
```bash
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 the same — `leadmaps connect google` opens the browser, you click
**Allow**, and we **auto-create a Sheet** in your Drive:
```bash
leadmaps connect google
leadmaps run --niche "cafe" --location "Kolkata" --limit 30 --to gsheets
```
Switch accounts or log out any time:
```bash
leadmaps disconnect notion | google | all     # removes the local token
```
Buyer setup (dead simple, both editions): **[lemonsqueezy/SETUP.md](lemonsqueezy/SETUP.md)**.
How the keyless connect stays secure (auth broker): **[DEPLOYMENT.md](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):
```bash
# 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:
```bash
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:
```bash
# 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. (Developers with Go: `go install github.com/AuraDevs7/leadmaps/go/cmd/leadmaps@latest`.)

---

## Same CLI, both editions
```bash
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`](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](lemonsqueezy/SETUP.md)** — buyer setup, both editions, dead simple.
- **[DEPLOYMENT.md](DEPLOYMENT.md)** — the Cloudflare Worker: site, auth broker and licensing.
- **[skills/leadmaps/SKILL.md](skills/leadmaps/SKILL.md)** — the agent operating manual.
- **[TESTS.md](TESTS.md)** — real runs with captured output.

Built by Auradevs.
