Skunkworks Local Lead Generator

📊 What you get

Daily CSV export in a standard schema, ready for your dialler/CRM with full audit trail and compliance markers.

CSV columns	Description
`msisdn`	Mobile number (E.164, ZA)
`full_name`	Optional contact name
`employment_status`	employed \| self_employed
`vehicle_owner`	true/false
`province`	Region (if present)
`consent_status`	opt_in \| first_contact_only \| unknown
`source`	Partner / Microsite / Directory
`quality_score`	0—100 prioritisation
`last_verified_at`	UTC timestamp
`notes`	Free text / provenance
`vehicle_ownership_probability`	0—1 probability (self‑learning)
`signals`	JSON of audit signals

⚙️ How it works (local‑first)

Automated pipeline that processes, validates, and enriches leads while maintaining full compliance and data sovereignty.

Inputs: Partner CSVs → ./inbox/; optional whitelisted pages in ./seeds/; local DNC in ./dnc/.
Validation: normalise to E.164; ensure mobile (not landline/VoIP).
Gating: keep only employed/self‑employed, and owns car by flag or probability ≥ 0.60.
Scoring & dedupe: compute quality score and persist a single freshest record per number (SQLite).
Exports: daily‑rotated CSV in ./out/.

🤖 Self‑learning: drop agent outcomes (mobile, owns_car_confirmed) into ./outcomes/ to improve probabilities.

🔒 Compliance & privacy

Use sources with ToS that permit reuse; keep source & signals for audit.
Local DNC enforced; update via CSVs in ./dnc/.
No NaTIS/DHA scraping; partner plugins can be added later.
Offline by default—data stays on your machine.

📦 What Skunkworks provides

Windows‑packaged Local Lead Generator app.
Config & CSV templates (partners, DNC, outcomes, seeds).
Quick‑start guide + light operator training.
Branding and column/threshold tweaks as needed.

✅ Client responsibilities

Provide compliant input sources; confirm ToS where applicable.
Supply up‑to‑date DNC lists.
Share agent outcomes periodically to improve accuracy.
Approve gating thresholds (e.g., quality ≥ 70; probability ≥ 0.60).

🏆 Why it wins
Local, fast, compliant: zero cloud—just your PC.
Dialler‑ready daily with clear audit fields.
Self‑improving via simple outcome drops—no data‑science team required.