Files

T

Ken f09317f95b feat: add noVNC headed mode for interactive browser sessions

- Dockerfile with Xvfb + x11vnc + noVNC for browser-in-a-URL
- search.py auto-detects DISPLAY env to run headed vs headless
- pause_for_human() function for CAPTCHA/login handoff
- Facebook Marketplace search (headed mode only, needs login)
- Updated README with both modes

2026-05-25 06:56:21 +00:00

1.1 KiB

Raw Blame History

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.