Ken 8dfafcc63d feat: car-help web UI with browser view, search API, and buying guide
- FastAPI backend on port 8080 with noVNC proxy for same-origin iframe
- Split-panel UI: live browser (55%) + search/guide/saved tabs (45%)
- Car buying guide: target models, pre-purchase checklist, mechanics nearby,
  negotiation tips, budget breakdown
- Scoring/ranking engine for listings (Toyota Prius = highest)
- Docker container runs Xvfb + x11vnc + noVNC + FastAPI together
- Accessible at browser.ampbox.io via cloudflared tunnel
2026-05-25 20:34:16 +00:00

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.

S
Description
Research Workbench
Readme 406 KiB
Languages
TypeScript 51.6%
Python 24.2%
Shell 17.8%
HTML 2.7%
CSS 2%
Other 1.7%