Skip to content
active

Lead Generator Bot

Locally-run lead generation tool that finds and enriches business contacts using public APIs.

Python · FastAPI · React · TypeScript · WebSocket

A locally-run lead generation tool designed for non-technical users. Point it at an industry and location, and it finds businesses, enriches contact data, and presents leads in a clean interface.

Architecture

  • Backend — Python/FastAPI server with WebSocket for real-time progress updates
  • Frontend — React/TypeScript dashboard for configuring searches and reviewing leads
  • Data Sources — Google Places API for business discovery, Serper API for web enrichment
  • Enrichment — Multi-stage pipeline: find businesses → scrape details → extract emails → verify

Why Locally-Run

The tool runs on your machine, not in the cloud. Lead data stays local, API keys stay local, and there’s no subscription fee — just the API costs for the searches you actually run. Built for sales professionals who want control over their prospecting pipeline.

Status

Phases 1-4 complete: setup wizard, Google Places discovery, the tiered scraping pipeline, and email enrichment are all working, with live progress over WebSocket and config managed entirely in the UI (no .env editing, plain-English error messages). Recently bumped back up the priority list after realizing it feeds leads to the other products — remaining work is export (CSV/clipboard) and packaging polish.