🎯 VoiceAI Auto-Prospect Finder

Find and qualify high-quality business leads with AI-powered prospect scoring. Automatically discovers contact information, validates phones, enriches emails, and intelligently analyzes websites to detect engagement opportunities like missing chat widgets, contact forms, and availability gaps.

🌟 Features

• 🗺️ Multi-Source Data Collection: Scrapes Google Maps (via Outscraper or Apify actors) and Yelp
• 📧 Smart Email Discovery: Finds and validates business emails from multiple sources (website scraping, Apollo, Outscraper)
• 📞 Phone Validation: Validates and formats phone numbers to E.164 standard
• 🏆 Better Business Bureau (BBB): Enriches with BBB ratings and review counts
• 🔍 Website Intelligence Signals: Automatically detects key engagement indicators:
  • 💬 Chat Widget Detection: Identifies if business has live chat support
  • 📝 Contact Form Analysis: Checks for web forms and lead capture mechanisms
  • 📅 Weekend/After-Hours Availability: Detects businesses open on weekends or claiming 24/7 service
  • ✉️ Email Deliverability: Validates domain MX records to ensure emails will deliver
  • 📱 Social Media Activity: Tracks recent Facebook posts and engagement
• 🤖 AI-Powered Scoring: Intelligent lead scoring (Tier A/B/C) based on:
  • Review ratings and volume
  • Website engagement signals (missing chat = opportunity)
  • Email/phone availability and quality
  • BBB ratings and business reputation
  • Social media activity and freshness
• 🔗 CRM Integration: Push qualified leads directly to GoHighLevel/LeadConnector with rich contact data
• 📬 Real-time Notifications: Slack and Telegram alerts for hot leads
• 🎨 Email Source Tracking: Know exactly where each email came from (website, Outscraper, Apollo)

💡 Use Cases

• Voice AI Lead Generation: Find businesses without 24/7 answering services or live chat (prime candidates for AI phone automation)
• Chat Widget Opportunities: Identify businesses lacking chat support to pitch live chat or AI chatbot solutions
• After-Hours Service Gap: Target businesses not open weekends/24-7 who are missing calls
• Local Service Businesses: Target roofers, plumbers, contractors, restaurants with missing engagement tools
• Sales Prospecting: Build targeted B2B lead lists with verified contact info and pain point indicators
• Market Research: Analyze competitor landscapes and identify service/technology gaps
• CRM Enrichment: Enhance existing leads with intelligence signals and quality scores

🚀 Quick Start

Input Configuration

{
  "keywords": ["roofer", "roofing contractor"],
  "locations": ["Dallas, TX", "Houston, TX"],
  "maxResultsPerLocation": 20,
  "gmapsProvider": "outscraper",
  "enableOutscraper": true,
  "enableApollo": true,
  "emailDiscovery": true,
  "phoneValidation": true
}

Environment Variables

Set these in the Apify Console under Settings → Environment Variables:

Variable	Description	Required
OUTSCRAPER_API_KEY	Outscraper API key for Google Maps data	Yes (if using Outscraper)
GMAPS_ACTOR_ID	Apify actor ID for Google Maps	Yes (if using Apify)
APOLLO_API_KEY	Apollo API key for email enrichment	Optional
PHONEVALIDATOR_KEY	Phone validation API key	Optional
SLACK_WEBHOOK_URL	Slack webhook for notifications	Optional
TELEGRAM_BOT_TOKEN	Telegram bot token	Optional

📖 Complete Setup Guide - Step-by-step configuration instructions

📊 Output Format

Each prospect includes:

{
  "name": "Acme Roofing",
  "category": "Roofing contractor",
  "address": "123 Main St, Dallas, TX 75201",
  "city": "Dallas",
  "state": "Texas",
  "postalCode": "75201",
  "country": "US",
  "latitude": 32.7767,
  "longitude": -96.7970,
  "website": "https://acmeroofing.com",
  "phone_raw": "(214) 555-0100",
  "phone_e164": "+12145550100",
  "phone_meta": {
    "valid": true,
    "carrier": "AT&T",
    "line_type": "mobile"
  },
  "emails": [
    "info@acmeroofing.com",
    "contact@acmeroofing.com"
  ],
  "email_sources": {
    "base": ["info@acmeroofing.com"],
    "outscraper": ["contact@acmeroofing.com"],
    "apollo": []
  },
  "reviews": {
    "rating": 4.8,
    "count": 127
  },
  "bbbRating": "A+",
  "bbbReviews": 45,
  "signals": {
    "hasChat": true,
    "formExists": true,
    "weekendOpen": false,
    "claim247": false,
    "recentFbPosts": 3,
    "mxOk": true
  },
  "score": 0.89,
  "tier": "A",
  "score_breakdown": {
    "missedCallsRisk": 0.25,
    "reviewPain": 0.20,
    "leadVelocity": 0.25,
    "contactability": 0.19
  },
  "sources": ["google-maps-outscraper", "website"],
  "createdAt": "2025-11-09T20:00:00.000Z",
  "outscraper_raw": {
    "place_id": "ChIJ...",
    "google_id": "0x864c218f...",
    "logo": "https://lh3.googleusercontent.com/...",
    "photo": "https://lh3.googleusercontent.com/...",
    "reviews_link": "https://search.google.com/local/reviews?...",
    "verified": true,
    "business_status": "OPERATIONAL"
  }
}

🔍 Understanding Signals

The signals object contains key indicators for identifying sales opportunities:

Signal	Meaning	Opportunity
hasChat	Website has live chat widget	false = Opportunity to sell chat/AI solutions
formExists	Website has contact forms	false = Missing lead capture mechanism
weekendOpen	Open on Saturdays/Sundays	false = Missing weekend call opportunities
claim247	Claims 24/7 availability	false = After-hours calls going to voicemail
recentFbPosts	Number of recent Facebook posts	Low = Inactive social media presence
mxOk	Email domain has valid MX records	true = Emails will deliver successfully

💡 Pro Tip: Businesses with hasChat: false and weekendOpen: false are prime candidates for Voice AI solutions - they're likely missing calls outside business hours!

🎯 Scoring System

Prospects are automatically scored and tiered:

• Tier A (≥0.75): 🔥 Hot leads - High priority, immediate follow-up
• Tier B (0.55-0.74): 🟡 Warm leads - Good follow-up targets
• Tier C (<0.55): ❄️ Cold leads - Low priority or nurture

Scoring Factors

1. Missed Calls Risk (25%): Low online engagement = more missed calls
2. Review Pain (20%): Negative reviews or low ratings
3. Lead Velocity (25%): No chat/forms = slower lead capture
4. Contactability (30%): Missing contact info reduces reachability

🔧 Google Maps Provider Options

Option 1: Outscraper (Recommended)

Advantages:

• ✅ Better data quality and reliability
• ✅ More complete business information
• ✅ Direct API access (no actor dependencies)
• ✅ Async processing with automatic polling
• ✅ Includes rich metadata (place_id, google_id, photos, logos)

Configuration:

{
  "gmapsProvider": "outscraper",
  "outscraperGmapsKey": "YOUR_API_KEY"
}

Get API key: https://app.outscraper.com/

⏱️ Note: Outscraper uses async processing - requests take 30-60 seconds to complete. The actor automatically polls for results every 5 seconds.

Option 2: Apify Actors

Supported Actors:

• compass/crawler-google-places (default)
• apify/google-maps-scraper
• Custom actors

Configuration:

{
  "gmapsProvider": "apify"
}

Set GMAPS_ACTOR_ID environment variable.

📧 Email Enrichment

Email discovery uses multiple sources and tracks origins:

Sources

1. Base Discovery: Scrapes emails from business websites
2. Outscraper: Extracts additional emails via Outscraper Email Scraper API
3. Apollo: Retrieves company email patterns from Apollo.io

Email Source Tracking

Every prospect includes email_sources showing where each email originated:

{
  "emails": ["info@example.com", "sales@example.com", "contact@example.com"],
  "email_sources": {
    "base": ["info@example.com"],
    "outscraper": ["sales@example.com", "contact@example.com"],
    "apollo": []
  }
}

🔗 Integrations

GoHighLevel (LeadConnector)

Push qualified leads directly to your GHL CRM:

{
  "pushToGHL": true,
  "ghl": {
    "apiKey": "YOUR_GHL_API_KEY",
    "locationId": "YOUR_LOCATION_ID",
    "pipelineId": "YOUR_PIPELINE_ID",
    "stageId": "YOUR_STAGE_ID",
    "source": "VoiceAI Auto-Prospect"
  }
}

Webhooks

Send leads to any webhook endpoint (n8n, Make, Zapier, etc.):

{
  "webhook": "https://your-webhook-url.com/endpoint"
}

Notifications

Get instant alerts for Tier A leads:

Slack:

{
  "enableSlack": true,
  "slackWebhookUrl": "https://hooks.slack.com/services/..."
}

Telegram:

{
  "enableTelegram": true,
  "telegramBotToken": "YOUR_BOT_TOKEN",
  "telegramChatId": "YOUR_CHAT_ID"
}

💰 Pricing Estimates

Apify Platform Costs

• Small run (50 prospects): ~$0.05 - $0.15
• Medium run (200 prospects): ~$0.20 - $0.50
• Large run (1000 prospects): ~$1.00 - $3.00

External API Costs

Outscraper:

• Google Maps: ~$0.02 per result
• Email extraction: ~$0.005 per domain

Apollo:

• Free tier: 50 requests/month
• Paid: Starting at $49/month

🎬 Sample Workflows

Use Case: VoiceAI Lead Gen for Roofers

{
  "keywords": ["roofer", "roofing contractor"],
  "locations": ["Dallas, TX", "Fort Worth, TX"],
  "maxResultsPerLocation": 50,
  "gmapsProvider": "outscraper",
  "enableOutscraper": true,
  "enableApollo": true,
  "pushToGHL": true,
  "enableSlack": true
}

Result: 100 qualified roofing leads with emails, phones, and scores. Tier A leads (75+) automatically pushed to GHL and Slack notification sent.

Use Case: Restaurant Lead List

{
  "keywords": ["restaurant", "pizza", "italian restaurant"],
  "locations": ["Manhattan, NY", "Brooklyn, NY"],
  "maxResultsPerLocation": 30,
  "gmapsProvider": "outscraper",
  "enableOutscraper": false,
  "phoneValidation": true
}

Result: 180 restaurant prospects with validated phone numbers for cold calling campaigns.

📚 Documentation

• ./APIFY_USAGE_GUIDE.md - Step-by-step Apify configuration
• Input Schema Reference - All available options
• Output Format - Field descriptions

🐛 Troubleshooting

"No prospects collected"

• ✅ Check your search terms return results on Google Maps
• ✅ Verify API keys are configured correctly
• ✅ Try switching between outscraper and apify providers

"PhoneValidator Error 404"

• ✅ This is expected - fallback validation is automatically used
• ✅ Consider alternative phone validation services (Twilio, NumVerify)

"Outscraper Error"

• ✅ Verify API key is valid at https://app.outscraper.com/profile
• ✅ Check you have sufficient credits

"Authentication token was not provided"

• ✅ Add required API keys to environment variables in Apify Console

📝 License

MIT License - See LICENSE file for details

🤝 Support

• Issues: GitHub Issues
• Documentation: ./APIFY_USAGE_GUIDE.md
• Apify Console: Actor Settings

---

Built with ❤️ for Voice AI lead generation