# Cast Iron Scout 🔥🍳

Autonomous agent that scans for undervalued cast iron cookware deals and alerts you when pieces are priced ≥50% below fair market value.

## Status: 🚧 Prototype

**Built:** April 9, 2026  
**Current Sources:** eBay (RSS feeds)  
**Next:** Facebook Marketplace, Craigslist integration

## What It Does

1. **Scans** marketplaces every hour for cast iron cookware
2. **Identifies** brands (Griswold, Wagner, Wapak, Birmingham, Lodge, etc.)
3. **Calculates** fair market value based on brand, type, and size
4. **Alerts** you via Telegram when deals ≥50% below FMV are found
5. **Tracks** seen items to avoid duplicate alerts

## Example Alert

```
🔥 CAST IRON DEAL ALERT!

Item: Griswold #8 Skillet - Slant Logo
Price: $45.00
FMV: $180.00
Discount: 75% below FMV! 💰

Source: eBay
Found: 2026-04-09T17:44:23

🔗 [link to item]

Action: Buy now / Bid / Ignore
```

## Architecture

```
cast-iron-scout/
├── scanner.py           # Main scanning engine
├── valuation.py         # FMV calculator
├── config.json          # Your preferences
├── state/              # Track seen items
├── logs/               # Scan logs
└── sources/
    ├── ebay_scanner.py  # eBay scanner (RSS)
    ├── facebook.py      # [TODO]
    └── craigslist.py    # [TODO]
```

## Configuration

Edit `config.json` to customize:
- **min_discount_percent**: Minimum discount to alert (default: 50%)
- **max_distance_miles**: Max distance for local pickup (default: 500)
- **preferred_brands**: Brands to prioritize
- **item_types**: Types of items to scan for
- **telegram_target**: Where to send alerts

## Current Features

✅ Basic eBay RSS scanning  
✅ Brand identification (Griswold, Wagner, Wapak, etc.)  
✅ FMV calculation engine  
✅ Telegram alerts  
✅ Duplicate prevention  
✅ Hourly scanning  

## Known Issues / TODO

- [ ] eBay RSS feed unreliable - need to implement proper scraping
- [ ] Add Facebook Marketplace scanner
- [ ] Add Craigslist scanner
- [ ] Image recognition for logos/marks
- [ ] Price history tracking
- [ ] Condition assessment from photos
- [ ] Mobile app integration?

## Running Manually

```bash
cd /Users/claw/.openclaw/workspace/agents/cast-iron-scout
python3 scanner.py
```

## Logs

Check `logs/scanner-YYYYMMDD.log` for scan history.

## Next Steps

1. Fix eBay scanner (use proper HTML scraping vs RSS)
2. Add Facebook Marketplace (requires Selenium/Playwright)
3. Add image recognition for logos
4. Build sold items database for better FMV

---

**Maintained by:** Forge (Chris's SaaS Operations Bot)  
**Version:** 0.1.0 (Prototype)
