Working Ebay Scraping

README.md

@@ -23,6 +23,13 @@ db_port=3306
 db_user=trainid
 db_pass=changeme
 db_name=trainid
+
+# eBay API (optional - falls back to scraping if not configured)
+# Get credentials from https://developer.ebay.com/my/keys
+# Create an app and use the Client ID and Client Secret
+EBAY_CLIENT_ID=YourAppId...
+EBAY_CLIENT_SECRET=YourClientSecret...
+EBAY_SANDBOX=false  # Set to 'true' to use eBay sandbox environment
 ```
 
 ## Local development
@@ -42,6 +49,16 @@ Visit `http://localhost:3000`.
 - GET `/api/export/xlsx` → download XLSX export of inventory with embedded thumbnails
 - DELETE `/api/items/:id` → delete one
 - DELETE `/api/items` → wipe all
+- GET `/api/debug/ebay-prices?sku=...` → debug eBay price lookup (shows API and scraping attempts)
+- POST `/api/prices/update` → update cached prices for all SKUs from eBay
+- GET `/api/price-report` → get price report with item values
+
+### eBay Price Checking
+The system uses eBay's Browse API to search for items by SKU. **Important limitations:**
+- **Browse API only searches active listings**, not sold/completed ones
+- For sold/completed listings, the system falls back to web scraping
+- In sandbox mode, test data is limited - you may see 0 results even if the API is working correctly
+- The API method: `GET /buy/browse/v1/item_summary/search` with query parameter `q` (SKU)
 
 ## Debian 13 (Trixie) LXC install
 These steps assume a fresh Debian 13 LXC and deployment directory `/opt/Train-ID` with a system user `deployuser` that has passwordless sudo for service management.