lead-gen-cli

A CLI tool that finds local businesses, analyzes website quality, and exports scored leads to Excel for outreach and redesign opportunities.

overview

Scans search results, visits websites, and scores them based on technical and marketing quality signals.

Goal: identify low-quality business websites with high improvement potential.

features

• DuckDuckGo / Google search-based lead discovery
• website quality scoring (SEO + UX + technical checks)
• Wix / Squarespace / GoDaddy detection
• SSL, metadata, mobile responsiveness checks
• broken image detection
• parallel scraping for speed
• WHOIS domain age lookup
• rule-based outreach message generation (no API)
• Excel export with scoring + formatting

quick start

pip install -r requirements.txt

python lead-gen.py

cli usage

python lead-gen.py -q "plumber Chicago" -p 2 -o leads.xlsx

python lead-gen.py -q "hvac Dallas" -q "roofing Austin" -p 2 --min-score 60

python lead-gen.py --engine google -q "site:wixsite.com dentist phoenix" -p 3

python lead-gen.py -q "landscaper Seattle" --ai -o leads.xlsx

python lead-gen.py -q "electrician Denver" --no-analyze

python lead-gen.py --debug -q "dentist Austin"

scoring

SITE SCORE (lower = worse site)

• no HTTPS: -25
• Wix/Squarespace/GoDaddy: -20
• Wix free subdomain: -30
• missing viewport: -15
• slow load (>4s): -10
• missing title/meta: -10
• missing H1: -5
• no contact info: -5
• broken images: -10

LEAD SCORE (higher = better opportunity)

• Wix site: +30
• free subdomain: +20
• slow load: +15
• no SSL: +15
• no contact info: +10
• domain age > 5 years: +10

output

Excel includes:

• business name
• website
• site score
• lead score
• builder type
• domain age
• load time
• issues
• contact info
• outreach message (optional)
• search metadata

notes

• Google may block requests; DuckDuckGo is more reliable
• WHOIS lookups may fail silently
• use --no-analyze for faster runs
• scoring is heuristic-based