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.

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

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