Skip to content

Lead Generator Bot

active

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

Python FastAPI React TypeScript WebSocket
GitHub ↗

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

Phase 4 of 6 complete (email enrichment working). Phases 5-6 cover batch processing and export features.