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.