LeadScout

CLI tool that finds local restaurants without websites or with poor ones and scores them as freelance web design leads.

Stack

• Framework: Python 3.12+ with Click CLI, packaged via uv and hatchling
• Services: Google Places (New), Google Custom Search, Google PageSpeed Insights
• HTTP: httpx with tenacity retry/backoff
• Browser automation: Playwright (headless Chromium) for DOM audits
• Matching: rapidfuzz for fuzzy name comparison

Setup

git clone <repo-url>
cd lead_scout
uv sync

# add GOOGLE_PLACES_API_KEY to .env
uv run playwright install chromium
uv run leadscout run --location "Your City, ST"

Planned

• Campaign mode: multi-day, multi-location scans driven by campaign.toml
• Outreach export: templated email and contact list output from ranked leads