Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

📊 Lead Gen Pipeline

Automated Local Business Discovery & Outreach

Python Google Maps Gmail Supabase Claude Status


📋 The Problem

Finding qualified local business leads for an AI agency is manual and tedious. Searching Google Maps, checking websites, writing personalized outreach — it takes hours per lead and scales poorly.

💡 The Solution

An automated pipeline that discovers local businesses fitting your ideal customer profile, enriches them with contact info and website data, scores their fit, and generates personalized Gmail outreach drafts — all on a scheduled cadence.


✨ How It Works

Pipeline Workflow

┌────────────────┐    ┌────────────────┐    ┌────────────────┐
│  Google Maps   │    │  Website       │    │  AI Scoring    │
│  Places API    │───▶│  Scraper       │───▶│  + Enrichment  │
└────────────────┘    └────────────────┘    └────────┬───────┘
                                                     │
                                            ┌────────▼───────┐
                                            │  Gmail Draft   │
                                            │  Generator     │
                                            └────────────────┘

Step-by-step

  1. Discovery — Search Google Maps Places API for businesses in target categories (e.g. "NYC property management", "NJ physical therapy")
  2. Enrichment — Visit each business's website to extract services, size, tech stack, and contact info
  3. Scoring — AI evaluates fit based on your ideal customer profile (size, industry, tech readiness)
  4. Outreach Drafting — For high-scoring leads, generate a personalized Gmail draft with context about their business
  5. Scheduling — Runs on a configurable cron schedule with daily digest of new leads found

🛠 Tech Stack

  • Language: Python
  • Discovery: Google Maps Places API
  • Enrichment: Web scraping + Claude AI
  • Database: Supabase (PostgreSQL)
  • Outreach: Gmail API (via Google Workspace)
  • Scoring: Claude AI + custom heuristics
  • Scheduling: Cron-based pipeline
  • Deployment: Local system (Hermes Agent)

🚀 Status

🟢 Production deployed — actively discovering and qualifying leads for Level Up Digital's AI agency services.


🏁 Getting Started

git clone https://github.com/terryhuangjr-lgtm/lead-gen-pipeline.git
cd lead-gen-pipeline

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
# Add: Google Maps API key, Gmail credentials, Claude API key

python pipeline.py

About

Automated local business discovery and outreach using Google Maps + Gmail

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors