Nigeria Leads Bot — Telegram lead generation & enrichment bot for Nigerian B2B prospecting
# Nigeria Leads Bot
A Telegram B2B lead-generation bot (`@LeedAibot`) that discovers, enriches,
qualifies, organises and exports Nigerian business leads from legal public
sources.
## Features
- **Real discovery** — OpenStreetMap/Overpass (primary), optional Google/Bing Places.
- **Nigeria coverage** — 15+ major cities (Lagos, Abuja, Port Harcourt, Benin City,
Kano, Ibadan, Enugu, Aba, Onitsha, Warri, Uyo, Calabar, Kaduna, Jos…) and 36 states.
- **Industries** — construction, real estate, accounting, law, schools, universities,
hospitals, clinics, hotels, restaurants, logistics, manufacturing, retail, churches,
NGOs, tech, SMEs, commercial cleaning.
- **Enrichment** — website title, business-email harvesting + verification,
lead scoring and qualification.
- **Prospect packs** — one-click pre-scoped searches.
- **CRM pipeline** — `New → Researched → Contacted → … → Won/Lost`.
- **Sales intel** — cold email, call script and LinkedIn note per lead.
- **Campaigns** — multi-city collection with duplicate skipping.
- **Exports** — CSV, Excel (CSV-compatible), JSON, Google Sheets (TSV),
HubSpot, GoHighLevel, Pipedrive.
## Commands
| Command | Description |
|---|---|
| `/start` | Welcome + menu |
| `/menu` | Inline main menu |
| `/help` | All commands |
| `/status` | Bot + data-source status |
| `/find ` | Discover leads |
| `/search ` | Search top cities |
| `/packs` | One-click prospect packs |
| `/campaign \| \| ` | Create + run campaign |
| `/campaigns` | List campaigns |
| `/pipeline` | CRM stages |
| `/stages` | List stages |
| `/stage ` | Move a lead |
| `/leads` | Recent leads |
| `/intel ` | Sales intel + outreach |
| `/export [format]` | CSV/Excel/JSON/CRM |
| `/stats` | Database stats (owner) |
| `/owner` | Claim ownership |
| `/migrate ` | Migrate owner (owner) |
| `/offer …` | Set outreach introduction |
## Run locally
```bash
pip install -r requirements.txt
cp .env.example .env # then fill TELEGRAM_BOT_TOKEN + OWNER_ID
python -m bot.mai …