How gopi514-chand/autonomous-lead-enrichment-agent works
AI Lead Enrichment Agent accepts company domains through a Flask interface or CLI, crawls public company pages, extracts and validates structured lead records, and presents or saves JSON results. The README documents page discovery, DOM cleaning, social-link detection, optional OpenAI extraction, and a deterministic fallback. The lead_enricher.py excerpt is incomplete, so uncertain internal call wiring is omitted; the documented capabilities remain represented.
Main entry points: lead_enricher.py Enrichment workflow · app.py Flask interface · index.html Browser form
Components 19
User entry points
- Browser form
templates/index.html - Flask interface
app.py - CLI entry point
lead_enricher.py
Website collection
- Domain normalization
lead_enricher.py - Domain crawler
lead_enricher.py - Playwright browser
- Page discovery
lead_enricher.py - DOM cleaning
lead_enricher.py - Social-link detection
lead_enricher.py
Profile extraction
- Enrichment workflow
lead_enricher.py - OpenAI extraction
lead_enricher.py - Heuristic extraction
lead_enricher.py - Profile validation
lead_enricher.py
Results and state
- JSON output
lead_enricher.py - In-memory job state
app.py
Other components
- Prospecting user
- CLI operator
- Company websites
- OpenAI service
Connections 22
- Prospecting user → Browser form: enters domains
- Browser form → Flask interface: submits form
- Flask interface → Enrichment workflow: enriches domains
- Flask interface → In-memory job state: tracks jobs
- CLI operator → CLI entry point: provides domains
- CLI entry point → Enrichment workflow: enriches domains
- CLI entry point → JSON output: writes records
- Enrichment workflow → Domain normalization: normalizes domain
- Enrichment workflow → Domain crawler: crawls domain
- Domain crawler → Playwright browser: loads pages
- Playwright browser → Company websites: requests pages
- Domain crawler → Page discovery: discovers links
- Domain crawler → DOM cleaning: cleans page content
- Domain crawler → Social-link detection: detects social links
- Enrichment workflow → OpenAI extraction: tries extraction
- OpenAI extraction → OpenAI service: requests extraction
- Enrichment workflow → Heuristic extraction: falls back
- Heuristic extraction → Social-link detection: uses discovered links
- Heuristic extraction → Profile validation: validates record
- OpenAI extraction → Profile validation: validates record
- Profile validation → Enrichment workflow: returns profile
- Enrichment workflow → Flask interface: returns results