34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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.
|