MarketingTool/README.md

# 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

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