leadflow - SKILL.md Agent Skill

name: leadflow

description: "Turn any city into a lead list in 60 seconds. Scrapes Google Maps & Yelp, enriches emails via 4-provider waterfall, verifies contacts, scores quality 0-100, and exports straight to your CRM. 50+ industries supported. Built by OnCall Automation."

metadata:

openclaw:

emoji: "\U0001F50D"

primaryEnv: GOOGLE_PLACES_API_KEY

requires:

  env:

    - GOOGLE_PLACES_API_KEY

  bins:

    - node

    - npm

optionalEnv:

  - YELP_API_KEY

  - HUNTER_API_KEY

  - APOLLO_API_KEY

  - DROPCONTACT_API_KEY

  - ZEROBOUNCE_API_KEY

  - TWILIO_ACCOUNT_SID

  - TWILIO_AUTH_TOKEN

install:

  - kind: node

    package: leadflow

    bins:

      - 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


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:


leadflow providers --json

Available Trades


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


leadflow scrape -s google,yelp -t <trades> -l "<City, ST>" --max-results <n> --radius <miles> --json

Examples:


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)


leadflow enrich --limit 100 --json

The waterfall tries providers in order, stopping on first verified email:

Website scrape (free, always runs) - scans contact/about pages
Hunter.io (if HUNTER_API_KEY set) - domain email search
Apollo.io (if APOLLO_API_KEY set) - people/company search
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


# 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


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


# 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)


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


# 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