LeadHunter Pro

Overview
LeadHunter Pro is a cutting-edge, full-stack lead generation platform that combines multi-platform business discovery with AI-powered data enrichment. Built for digital agencies, freelancers, and businesses, it delivers high-quality leads through intelligent search across Google, social media, and web platforms.

### 🎯 Key Highlights

- **Multi-Platform Discovery** - Search Google, Facebook, Instagram, LinkedIn, Twitter, TikTok, OpenStreetMap
- **AI-Powered Enhancement** - Groq AI with Llama 3.3 70B for data extraction and owner discovery
- **Advanced Web Scraping** - Firecrawl integration for comprehensive business data
- **Complete Lead Management** - Pipeline, campaigns, analytics, and export features
- **Professional Admin Panel** - User management, credits, crypto payments (BTC/ETH/USDT)
- **Production Ready** - One-command VPS deployment on Ubuntu/Linux

Features
### Search & Discovery
- ✅ Multi-platform business search (Google, social media, maps)
- ✅ AI-enhanced query analysis and optimization
- ✅ Advanced filtering (phone, email, owner names, website)
- ✅ Radius-based geographic search
- ✅ Real-time geocoding with interactive maps
- ✅ Owner/CEO/manager name discovery
- ✅ Contact information validation

### Lead Management
- ✅ Complete lead pipeline (new → contacted → qualified → converted)
- ✅ Lead scoring and quality assessment
- ✅ Conversation history tracking
- ✅ Custom notes and tags
- ✅ Priority management
- ✅ Campaign integration

### Campaign System
- ✅ Multi-channel campaigns (email, social, phone)
- ✅ Performance tracking (opens, clicks, conversions)
- ✅ Budget management
- ✅ Automated follow-up sequences
- ✅ A/B testing support
- ✅ CSV export

### Social Integration
- ✅ OAuth 2.0 for Facebook, Twitter, LinkedIn, Instagram, TikTok
- ✅ Token management and refresh
- ✅ Platform-specific business discovery
- ✅ Enhanced data extraction

### Admin Features
- ✅ Complete user management
- ✅ Credit allocation and top-ups
- ✅ Cryptocurrency payment configuration (BTC/ETH/USDT)
- ✅ Ban/unban users
- ✅ System-wide analytics
- ✅ Search history monitoring

Requirements
- Ubuntu 20.04+ or Debian 10+
- 2GB RAM minimum (4GB recommended)
- 20GB disk space
- Domain with DNS configured (optional)

Instructions


### One-Command Installation
```bash
# 1. Upload files to server (fresh vps server)
cd /opt/leadhunter-pro
# 2. Make installation script executable
chmod +x COMPLETE_SERVER_PACKAGE_INSTALLATION.sh
# 3. Run installation
sudo ./COMPLETE_SERVER_PACKAGE_INSTALLATION.sh
```
**Installation includes:**
- ✅ Node.js 20
- ✅ PostgreSQL database
- ✅ Nginx reverse proxy
- ✅ PM2 process manager
- ✅ Application dependencies
- ✅ Database schema
- ✅ Admin user creation
### Access Application
```
http://your-server-ip
# or
http://yourdomain.com
```
### Default Admin Login
```
Email: admin@leadhunter.com
Password: admin123
Username: superadmin
```
**⚠️ Change admin password immediately after first login!**