feat: Cast Iron Scout agent prototype
- Created autonomous cast iron deal scanner - Scans eBay RSS feeds hourly for cast iron cookware - Calculates FMV based on brand, type, size - Sends Telegram alerts for deals ≥50% below FMV - Identifies Griswold, Wagner, Wapak, Birmingham, Lodge, Victor - Tracks seen items to avoid duplicate alerts - Valuation engine with size multipliers - Configurable preferences in config.json Known issue: eBay RSS unreliable - next iteration will use proper scraping
This commit is contained in:
101
agents/cast-iron-scout/README.md
Normal file
101
agents/cast-iron-scout/README.md
Normal file
@@ -0,0 +1,101 @@
|
||||
# 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)
|
||||
Reference in New Issue
Block a user