How wesbos/yard-sale works
Yard Sale Gold is a camera- and upload-based scanner that identifies and values likely sale items, then saves findings for browsing. The main workflow samples frames in the browser, sends them to the Worker for agent analysis and research, and returns annotated findings to the live feed. Saved inventory, item details, agent activity, and batch processing are additional product branches. The supplied excerpts document the main calls and storage behavior; some UI and batch wiring is described only by the README, so uncertain internal links are omitted.
Main entry points: App.tsx Scan and live feed · index.ts Frame analysis API · agent.ts Frame analysis agent · router.tsx URL routes
Components 18
Capture and UI
- Scan and live feed
src/App.tsx - URL routes
src/router.tsx
Frame Analysis
- Frame analysis API
worker/index.ts - Batch processing
worker/index.ts - Frame analysis agent
worker/agent.ts - Fingerprint matching
worker/normalize.ts
Valuation Research
- Web research
- eBay search tool
worker/ebay.ts - eBay Browse API
Inventory and Evidence
- D1 inventory store
- Inventory schema
worker/db/schema.ts - R2 thumbnails
Finds and History
- History query
worker/history.ts - Saved finds
src/App.tsx - Find detail and export
src/App.tsx - Agent activity
src/App.tsx - Image export
src/download-modal.ts
Other components
- Scanner user
Connections 22
- Scanner user → Scan and live feed: captures or uploads
- Scanner user → URL routes: opens views
- Scan and live feed → Frame analysis API: sends sampled frames
- Scan and live feed → Batch processing: submits batch work
- Scan and live feed → Saved finds: filters inventory
- URL routes → Scan and live feed: selects route
- Frame analysis API → Frame analysis agent: runs analysis
- Frame analysis agent → Fingerprint matching: scores fingerprints
- Frame analysis agent → D1 inventory store: checks prior scans
- Frame analysis agent → Web research: researches products
- Frame analysis agent → eBay search tool: invokes search tool
- eBay search tool → eBay Browse API: searches listings
- Frame analysis API → D1 inventory store: saves findings and audit
- Frame analysis API → R2 thumbnails: stores thumbnails
- Frame analysis API → Scan and live feed: returns detected items
- Saved finds → History query: requests filtered pages
- History query → D1 inventory store: queries inventory
- Frame analysis API → Inventory schema: uses data model
- Find detail and export → Scan and live feed: loads item view
- Scan and live feed → Agent activity: opens run activity
- Agent activity → Frame analysis API: requests saved run
- Find detail and export → Image export: exports item image