MarketingTool/README.md

# 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.