1.1 KiB
Browser-only ProspectOS
This is the stripped-down replacement for the larger ProspectOS application.
It has one live source: Google Search through a headless Playwright Chromium
browser. Each discovery run builds a query from category, keywords, and
location, filters results already present in the local catalogue by root
domain, and stores only new prospects. The explorer supports search and
human review states (pending, approved, rejected, contacted).
There is deliberately no source registry, email scraper, AI provider, CRM, outreach sender, or automatic contact action.
Run with Docker
docker compose up -d --build
Open http://SERVER:8000.
If Google presents a CAPTCHA or bot challenge, the run fails safely. The app does not bypass challenges or rotate identities. Keep runs small and spaced out. The implementation uses a fresh headless browser context for each run.
Run locally
python -m pip install -r api/requirements.txt
PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium python api/server.py
The browser executable path can be changed for the host operating system.