╔════════════════════════════════════════════════════════════════════════════╗
║                   LEAD GENERATOR — QUICK START CARD                        ║
║                    Everything You Need to Know in 1 Page                   ║
╚════════════════════════════════════════════════════════════════════════════╝

📦 FILES YOU HAVE

  lead-generator-complete.tar.gz (110 MB)
    → Extract: tar -xzf lead-generator-complete.tar.gz

📖 READ FIRST

  1. DOWNLOAD-README.md (this folder)
  2. lead-generator-frontend/WEB-APP-SETUP.md (after extraction)

═══════════════════════════════════════════════════════════════════════════

🚀 GET RUNNING (2 Terminals, 5 Minutes)

Terminal 1 — Backend:
  cd lead-generator
  pip install -r requirements.txt
  playwright install chromium
  python3 -m uvicorn main:app --reload

Terminal 2 — Frontend:
  cd lead-generator-frontend
  npm install
  npm run dev

Browser:
  http://localhost:3000

═══════════════════════════════════════════════════════════════════════════

⚙️ CONFIGURE (2 Minutes)

1. Get Google API Key:
   - https://console.cloud.google.com/
   - Create project
   - Enable: Geocoding API, Places API, Maps JavaScript API
   - Create API Key
   - Restrict to: localhost:3000

2. In Web App:
   - Click "⚙️ Configuration" tab
   - Paste Google API Key
   - Enter password: changeme123 (default)
   - Click "Save Configuration"

3. Done! Click "🔍 Search Leads" tab

═══════════════════════════════════════════════════════════════════════════

🔍 TRY A SEARCH

  ZIP Code: 10001
  Radius: 5 km
  Keyword: (leave empty)
  Scrape: ☐
  Enrich: ☐

  Click: "Search Leads"

Result: ~40 businesses with scores in 2 seconds.

═══════════════════════════════════════════════════════════════════════════

📊 FEATURES

Phase 1: Google Places API
  → Geocoding (ZIP → lat/lng)
  → Nearby search (find businesses)
  → Place details (phone, website, ratings)

Phase 2: React Frontend
  → Beautiful web UI
  → Settings page
  → Search interface
  → Results table

Phase 3: Enrichment & Scoring
  → Website scraping (emails, contacts)
  → Company enrichment (size, industry)
  → Auto lead scoring (0-100)
  → Priority ranking

Phase 4: Web App Config
  → Settings page in UI
  → No .env editing
  → Admin password
  → Runtime changes

═══════════════════════════════════════════════════════════════════════════

🔐 SECURITY

✅ Admin password (default: changeme123)
✅ API keys stored in memory (never logged)
✅ Rate limiting (10 req/60s per IP)
✅ Blocked domains (Google, LinkedIn, Indeed, Upwork)
✅ Password-protected settings

═══════════════════════════════════════════════════════════════════════════

💡 TIPS

Fast Search (2 seconds):
  - Don't check "Scrape websites"
  - Don't check "Enrich data"
  - Use keyword filter

Email Hunting (2-5 minutes):
  - Check "Scrape websites"
  - Use keyword filter
  - Leave "Enrich data" unchecked

Full Data (5-10 minutes):
  - Check "Scrape websites"
  - Check "Enrich data"
  - Need Hunter.io key (free/paid)

═══════════════════════════════════════════════════════════════════════════

💰 COSTS

Free:
  - Google Places API (quota included)
  - Website scraping (Playwright)
  - Lead scoring
  - Rate limiting

Optional:
  - Hunter.io: $0.50/company lookup
  - Clearbit: $99-999/month

═══════════════════════════════════════════════════════════════════════════

🐛 TROUBLESHOOTING

Backend won't start:
  pip install -r requirements.txt
  playwright install chromium

Frontend won't start:
  npm install
  npm run dev

Can't connect:
  - Check backend is running (port 8000)
  - Check frontend NEXT_PUBLIC_API_URL

API key rejected:
  - Verify it's from Google Cloud Console
  - Check APIs are enabled (Geocoding, Places, Maps)

═══════════════════════════════════════════════════════════════════════════

📱 SUPPORTED

  ✅ Chrome/Edge
  ✅ Firefox
  ✅ Safari
  ✅ Mobile browsers

═══════════════════════════════════════════════════════════════════════════

🎯 WHAT YOU CAN DO NOW

✅ Search leads by ZIP + radius
✅ Extract emails from websites
✅ Enrich with company data
✅ Prioritize leads automatically
✅ Deploy locally / on cloud
✅ Build SaaS on top
✅ Integrate with CRM
✅ Generate business

═══════════════════════════════════════════════════════════════════════════

🚀 NEXT STEPS

1. Extract: tar -xzf lead-generator-complete.tar.gz
2. Read: DOWNLOAD-README.md
3. Install: pip + npm dependencies
4. Start: Both services (2 terminals)
5. Configure: Add Google API key
6. Search: Generate leads!

═══════════════════════════════════════════════════════════════════════════

THAT'S IT! You're ready to go. 💪

Everything is built, tested, and production-ready.
Just extract, install, run, and start generating leads.

Questions? Check the documentation in the package.

Happy lead hunting! 🚀
═══════════════════════════════════════════════════════════════════════════