camelcamelcamel-alerts

# CamelCamelCamel Alerts Automatically monitor your CamelCamelCamel RSS feed for Amazon price drops and get notified on Telegram. ## Quick Start 1. **Get your RSS feed URL** from CamelCamelCamel: - Go to https://camelcamelcamel.com/ and set up price alerts - Get your personal RSS feed URL (format: `https://camelcamelcamel.com/alerts/YOUR_UNIQUE_ID.xml`) 2. **Create a cron job** with YOUR feed URL (not someone else's!): ```bash cron add \ --job '{ "name": "camelcamelcamel-monitor", "schedule": "0 */12 * * *", "task": "Monitor CamelCamelCamel price alerts", "command": "python3 /path/to/scripts/fetch_rss.py https://camelcamelcamel.com/alerts/YOUR_UNIQUE_ID.xml" }' ``` **Important**: Replace `YOUR_UNIQUE_ID` with your own feed ID from step 1. Each person needs their own feed URL! 3. **Clawdbot will**: - Fetch your feed every 4 hours - Detect new price alerts - Send you Telegram notifications ## How It Works The skill uses two components: ### `scripts/fetch_rss.py` - Fetches your CamelCamelCamel RSS feed - Parses price alert items - Compares against local cache to find new alerts - Outputs JSON with new items detected - Caches item hashes to avoid duplicate notifications ### Cron Integration - Runs on a schedule you define - Triggers fetch_rss.py - Can be configured to run hourly, every 4 hours, daily, etc. ## Setup & Configuration **See [SETUP.md](references/SETUP.md)** for: - How to get your CamelCamelCamel RSS feed URL - Step-by-step cron configuration - Customizing check frequency - Cache management - Troubleshooting ## Alert Cache The script maintains a cache at `/tmp/camelcamelcamel/cache.json` to track which alerts have been notified. This prevents duplicate notifications. **Clear the cache** to re-test notifications: ```bash rm /tmp/camelcamelcamel/cache.json ``` ## Notification Format When a new price drop is detected, you'll receive a Telegram message like: ``` 🛒 *Price Alert* *PRODUCT NAME - $XX.XX (Down from $YY.YY)* Current price: $XX.XX Historical low: $ZZ.ZZ Last checked: [timestamp] View on Amazon: [link] ``` ## Customization ### Check Frequency Adjust the cron schedule (6th parameter in the `schedule` field): - `0 * * * *` → every hour - `0 */4 * * *` → every 4 hours (default) - `0 */6 * * *` → every 6 hours - `0 0 * * *` → daily ### Message Format Edit `scripts/notify.sh` to customize the Telegram message layout and emoji. ## Technical Details - **Language**: Python 3 (built-in libraries only) - **Cache**: JSON file at `/tmp/camelcamelcamel/cache.json` - **Feed Format**: Standard RSS/XML - **Dependencies**: None beyond Python standard library - **Timeout**: 10 seconds per feed fetch ## Troubleshooting If you're not receiving notifications: 1. **Verify the feed URL** works in your browser 2. **Check the cron job** exists: `cron list` 3. **Test manually**: ```bash python3 scripts/fetch_rss.py <YOUR_FEED_URL> /tmp/camelcamelcamel ``` 4. **Clear the cache** to reset: ```bash rm /tmp/camelcamelcamel/cache.json ``` 5. **Check Telegram** is configured in Clawdbot See [SETUP.md](references/SETUP.md) for more details.