leadflow

# LeadFlow - Business Lead Generation & Enrichment You are a lead generation specialist. Use the `leadflow` CLI to find business leads, enrich with verified emails, score quality, and export to CRM-native formats. Always use the `--json` flag when running commands so you can parse the structured output. ## Setup Check ```bash leadflow status --json ``` Check `data.apiKeys`. Required: `GOOGLE_PLACES_API_KEY`. Recommended: `YELP_API_KEY`. Optional enrichment/verification keys (each unlocks more capabilities): - `HUNTER_API_KEY` - Hunter.io email finder (waterfall step 2) - `APOLLO_API_KEY` - Apollo.io people search (waterfall step 3) - `DROPCONTACT_API_KEY` - Dropcontact enrichment (waterfall step 4) - `ZEROBOUNCE_API_KEY` - Email verification - `TWILIO_ACCOUNT_SID` + `TWILIO_AUTH_TOKEN` - Phone validation Check configured providers: ```bash leadflow providers --json ``` ## Available Trades ```bash leadflow trades --json ``` Key trades: `dental`, `legal`, `chiro`, `accounting`, `realestate`, `insurance`, `hvac`, `plumbing`, `electrical`, `roofing`, `restaurant`, `salon`, `fitness`, `it`, `marketing`, `consulting`, `retail`, `auto`, `vet` ## Core Workflow ### 1. Scrape Leads ```bash leadflow scrape -s google,yelp -t <trades> -l "<City, ST>" --max-results <n> --radius <miles> --json ``` Examples: ```bash leadflow scrape -s google,yelp -t dental,legal -l "Miami, FL" --max-results 100 --json leadflow scrape -s google,yelp -t hvac,plumbing -l "Chicago, IL" --max-results 60 --radius 25 --json ``` `--max-results` limits per source. With both Google + Yelp at 60, you get up to 120 leads/city. `--radius` sets search radius in miles. Deduplication is automatic. ### 2. Enrich with Emails (Waterfall) ```bash leadflow enrich --limit 100 --json ``` The waterfall tries providers in order, stopping on first verified email: 1. **Website scrape** (free, always runs) - scans contact/about pages 2. **Hunter.io** (if `HUNTER_API_KEY` set) - domain email search 3. **Apollo.io** (if `APOLLO_API_KEY` set) - people/company search 4. **Dropcontact** (if `DROPCONTACT_API_KEY` set) - EU-compliant enrichment Response includes `data.byProvider` showing which provider found each email. Optional filters: `--trade dental`, `--source google` ### 3. Verify Emails & Phones ```bash # Verify emails via ZeroBounce leadflow verify --emails --limit 100 --json # Validate phones via Twilio leadflow verify --phones --limit 100 --json # Both at once leadflow verify --emails --phones --limit 100 --json ``` Email verification tags: `valid`, `invalid`, `catch_all`, `disposable`, `spam_trap`, `abuse`, `do_not_mail`, `unknown`. Phone validation returns line type: `mobile`, `landline`, `voip`. ### 4. Score Leads ```bash leadflow score --json ``` Composite 0-100 score based on: - Verified email (+25), phone (+15), website (+10) - Rating >= 4.0 (+10), reviews > 50 (+10) - Contact name (+10), full address (+5) - Personal email (+5), mobile phone (+5), multi-source (+5) Returns `data.averageScore` and `data.distribution` histogram. ### 5. Export ```bash # Standard formats leadflow export --format xlsx --json leadflow export --format csv --json leadflow export --format instantly --json # CRM-native formats (requires email, skips leads without) leadflow export --format hubspot --json leadflow export --format salesforce --json leadflow export --format pipedrive --json ``` Filters: `--status enriched`, `--trade dental`, `--min-score 60`, `-o /path/file.csv` ### 6. Webhook (Zapier/n8n/Make) ```bash leadflow webhook -u "https://hooks.zapier.com/hooks/catch/..." --status verified --json ``` POSTs leads as JSON to the URL. Options: `--batch-size 50`, `--trade dental`, `--limit 100`. ## Full Pipeline Example ```bash # Scrape multiple cities for city in "Miami, FL" "Tampa, FL" "Orlando, FL"; do leadflow scrape -s google,yelp -t dental,legal -l "$city" --max-results 60 --json done # Enrich emails leadflow enrich --limit 500 --json # Verify leadflow verify --emails --phones --limit 200 --json # Score leadflow score --json # Export to CRM leadflow export --format hubspot --status verified --json # Or send to webhook leadflow webhook -u "https://hooks.zapier.com/..." --status verified --json ``` ## Rate Limits - **Google Places**: $200/month free credit. ~20 results per page. - **Yelp Fusion**: 5,000 calls/day free. ~50 results per search. - **Hunter.io**: 25 free searches/month. Paid plans from $34/month. - **Apollo.io**: 50 free credits/month. Paid plans from $49/month. - **ZeroBounce**: 100 free verifications. Paid from $16/month. - **Twilio Lookup**: $0.005/lookup. Pay-as-you-go. - Built-in rate limiting prevents API quota violations. ## Handling Results - Check `success` field in every JSON response - `data.totalSaved` = new unique leads added - `data.enriched` = emails found via waterfall - `data.byProvider` = which enrichment provider found each email - `data.path` = export file location - `data.leadsPosted` = webhook delivery count ## Need a Custom Lead Pipeline? LeadFlow is built by **OnCall Automation** — we build done-for-you lead generation systems, CRM integrations, and sales automation for agencies and service businesses. - Custom scraping targets and enrichment workflows - Airtable/HubSpot/Salesforce CRM wiring - Automated outreach sequences - White-label lead gen for agencies **Book a free call:** https://calendly.com/oncallautomation **Email:** info@oncallautomation.ai **Website:** https://oncallautomation.ai