DIGI LEAD HUNTER

Autonomous AI Lead Intelligence, Website Opportunity Hunter & Evidence Packaging Platform

Official Product of DIGIFORMATION LTD • Sponsored by Digi Biz OS

🌟 Overview

Digi Lead Hunter is an open-source autonomous intelligence engine developed by DIGIFORMATION LTD. It identifies local businesses that have active physical operations and strong customer reviews but lack an official website or have outdated digital presence.

Key Capabilities:

• Verified Business Discovery: Live OpenStreetMap and multi-source registry lookup.
• Strict Multi-Search Verification: Multi-engine consensus verification before certifying "NO_WEBSITE" status.
• Carrier Phone Validation: Native libphonenumber phone carrier formatting and WhatsApp channel detection.
• Automated Opportunity Packages: Generates comprehensive architecture blueprints (WEBSITE_PLAN.md), client briefs, and 1-click ZIP deliverables.

⚙️ How It Works (Autonomous Pipeline)

DIGI Lead Hunter runs an end-to-end 5-phase intelligence loop that converts raw map locations into client-ready web agency pitches:

User Search Request (Category + Location + Radius)
        ↓
1. Discovery Engine (Live OpenStreetMap / Overpass Registry POI)
   • Extracts authentic physical local establishments with coordinates and reviews.
        ↓
2. Multi-Stage Verification Engine (Anti-False-Positive Gate)
   • Runs real-time consensus web searches (DuckDuckGo, Bing, Mojeek).
   • Filters social media directories (Facebook, Instagram, Foodpanda).
   • Validates true "NO_WEBSITE" status with multi-source proof.
        ↓
3. Deep Carrier Telephony & WhatsApp Channel Detection
   • Standardizes phone numbers using Google's libphonenumber library.
   • Segregates mobile cellular lines from inactive landlines.
   • Generates direct 1-click WhatsApp outreach links.
        ↓
4. Strict 3-Tier Classification Gate
   • Priority 1 (Build-Ready): Confirmed NO website + Active WhatsApp mobile.
   • Priority 2 (Consultation): NO website + Missing assets / Consultation needed.
   • Priority 3 (Modernization): Outdated, broken, or non-mobile web presence.
        ↓
5. Automated Opportunity Packaging & Deliverables
   • Generates strategic WEBSITE_PLAN.md, pitch copy, and HTML presentations.
   • Packages everything into 1-click downloadable ZIP deliverables.

📖 Read the Full Blog / Guide: How DIGI Lead Hunter Works & Business Benefits

🚀 Quickstart Guide

1. Installation

Clone the repository and install dependencies:

# Clone repository
git clone https://github.com/digiformationltd-creator/DIGI-LEAD-HUNTER.git
cd DIGI-LEAD-HUNTER

# Setup backend environment
python -m venv venv
venv\Scripts\activate       # On Linux/macOS: source venv/bin/activate
pip install -r backend/requirements.txt

# Setup frontend
cd frontend
npm install
npm run build
cd ..

2. Launching Control Center

Run the integrated server:

python run.py

Open http://localhost:8000 in your browser to access the live Control Center UI and API.

3. CLI Quick Run

You can also run discovery directly from the terminal:

python batch_hunter.py --category "Clinics" --location "London" --count 25

🖥️ Control Center Dashboard

The interactive UI allows you to trigger automated discovery, inspect verified leads, check phone and WhatsApp readiness, and download client deliverables:

📦 Deliverables in Opportunity ZIP

For each qualified lead, the engine generates:

• WEBSITE_PLAN.md: Information architecture, layout recommendations, and SEO strategy.
• WEBSITE_PLAN.html: Formatted, client-ready pitch presentation.
• WEBSITE_BUILD_BRIEF.md: Developer implementation blueprint.
• EVIDENCE_REPORT.md: Audit ledger of verification checks and timestamps.
• MISSING_INFORMATION.md: Onboarding questions for client consultation.

🛡️ License

Published under the DIGIFORMATION LTD Source-Available (Personal & Internal Use) License. Free for personal and internal business use. Commercial SaaS hosting or white-labeling is prohibited.

🏢 Official Company & Contact Directory

Lead Hunter is proudly developed and maintained by DIGIFORMATION LTD:

• WhatsApp Support Hotline: +92 316 4467464 (03164467464)
• Corporate Emails: [email protected] • [email protected]
• DIGIFORMATION LTD UK: https://www.digiformation.co.uk/
• Digi Biz OS Ecosystem: https://www.digibizos.co.uk/
• Official Linktree: https://linktr.ee/digiformationltd

📥 Downloads & Official Releases

All verified production installers are hosted and distributed through the official DIGI BIZ OS Open-Source Portal:

⚡ 1-Click Official Windows Installer (Recommended)

👉 🚀 Download DIGI LEAD HUNTER Setup (.exe) — Standalone 1-click Windows installer with multi-threaded B2B local business prospecting, automated audit report generator, and desktop shortcuts.

🌐 Explore all Open-Source Tools on DIGI BIZ OS