1.2 KiB
Browser-only ProspectOS
This is the stripped-down replacement for the larger ProspectOS application.
It searches public engines (Google first, then Bing and DuckDuckGo if Google
challenges the server) 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.