Real-time, AI-powered contact hunting with a dash of Windows-95 nostalgia
A lightweight Flask app that automates your browser to scour the web for emails, phone numbers, and social handles — then streams the results to you in real time. Perfect for founders, recruiters, sales teams, and curious hackers who need fresh contacts now rather than sometime next week.
| ⚡ Feature | 🚀 What It Delivers |
|---|---|
| Live browser automation | Chrome/Edge driven by Browser-Use with smart retries and captcha handling |
| Instant progress feed | WebSocket logs update as each page is parsed—no more staring at a loading spinner |
| LLM-assisted parsing | LangChain + OpenAI extract structured contacts from messy HTML |
| Deduped contact vault | Normalizes contacts and stores them in a local contacts.json file to avoid duplicates |
| Secure secrets | User-provided API keys (e.g., for OpenAI) are encrypted using Fernet (AES in CBC mode with HMAC) from the cryptography library. The master encryption key is stored locally in .api_key, and the encrypted user API key is stored in .encrypted_api_key. Both files are correctly listed in .gitignore to prevent them from being committed to version control. Decrypted keys are held in memory only when actively being used by the application. |
| Retro Win-95 UI | Pixel-perfect buttons, gray panels, and a splash of neon green for that dial-up vibe |
| Screenshot 1 | Screenshot 2 | Screenshot 3 |
|---|---|---|
 |
 |
 |
Don't see images? Make sure the files live in
docs/screenshots/.
# 1 Clone the repo
git clone https://github.com/boshjerns/BrowserUse--Contact-Discovery-Agent.git
cd BrowserUse--Contact-Discovery-Agent
# 2 Install deps (create a venv if you like)
pip install -r requirements.txt
# 3 Provide your OpenAI key
# • EITHER export it as an env var …
export OPENAI_API_KEY="sk-…" # Windows PowerShell: setx OPENAI_API_KEY "sk-…"
# • OR simply paste it into the UI when the app starts — no env setup required.
# 4 Fire it up
python app.py # then open http://127.0.0.1:5000| Variable | Purpose | Default |
|---|---|---|
OPENAI_API_KEY |
LLM calls for parsing & reasoning (optional — can be entered in the UI) | none |
This project forks and extends the excellent Browser-Use library by Gregor Žunič & Magnus Müller.
Huge thanks to the Browser-Use community for paving the way in AI-driven browser automation. Jump into their Discord to see what others are building!
Bug reports & pull requests are welcome.
Got a feature idea? Open an issue or ping @boshjerns.
Released under the MIT License.