# Car Help

Used car search tool for finding Jude a reliable hybrid (HEV) in the Woodinville, WA area. Budget: $8-10K.

## Two Modes

### Headless (fast, no interaction)

Runs Chromium headless. Good for sites that don't need login. Skips Facebook Marketplace.

```bash
uv sync
uv run playwright install chromium
uv run python search.py
```

### Headed via noVNC (interactive, for logins/CAPTCHAs)

Runs Chromium inside Docker with a virtual display. Open the browser view in any web browser when you need to interact (login, solve CAPTCHAs, apply filters manually).

```bash
# Build once
docker build -t car-help .

# Run (browser visible at http://localhost:6080/vnc.html)
docker run -d --name car-help -p 6080:6080 -v $(pwd)/results:/app/results car-help

# Run a search (headed -- includes Facebook Marketplace)
docker exec -it car-help uv run python search.py

# View the browser live
open http://localhost:6080/vnc.html

# Stop
docker stop car-help && docker rm car-help
```

Results are saved to `results/search_<timestamp>.json`.

## Sites

See `sites.yaml` for the full list of car search sites, search parameters, and target models.