2.9 KiB
CamelCamelCamel Alerts Setup Guide
Overview
This skill monitors your personal CamelCamelCamel RSS feed for Amazon price drops and sends you Telegram notifications.
⚠️ Important: Each user must use their own CamelCamelCamel feed URL. Do not share or reuse someone else's feed URL—you'll only see alerts for their watchlist.
Prerequisites
- CamelCamelCamel RSS feed URL (e.g.,
https://camelcamelcamel.com/alerts/YOUR_FEED_ID.xml) - Telegram setup (Bot must have Telegram configured)
- Python 3 with urllib (built-in)
Setup Steps
1. Retrieve Your CamelCamelCamel Feed URL
- Go to CamelCamelCamel
- Create alerts for products you want to track
- Copy your personal RSS feed URL from the alerts page
Example format:
https://camelcamelcamel.com/alerts/46b7418010d2395d2f6fcea824e4ae18c699cfd3.xml
2. Configure Bot to Check the Feed
Add a cron job to check the feed periodically (recommend every 1-6 hours):
cron --action add \
--job '{
"name": "camelcamelcamel-check",
"schedule": "0 */4 * * *",
"task": "Check CamelCamelCamel price alerts",
"command": "python3 /home/goliso/bot/skills/camelcamelcamel-alerts/scripts/fetch_rss.py <YOUR_FEED_URL> /tmp/camelcamelcamel | jq '.alerts' | /home/goliso/bot/skills/camelcamelcamel-alerts/scripts/notify.sh"
}'
Replace <YOUR_FEED_URL> with your actual feed URL.
3. Cache Directory
The script stores a cache at /tmp/camelcamelcamel/cache.json to track which alerts have been seen.
Clear the cache if you want to re-trigger notifications for existing alerts:
rm /tmp/camelcamelcamel/cache.json
How It Works
- Fetch: Downloads your RSS feed
- Parse: Extracts price alert items
- Compare: Checks against cache to identify new/updated items
- Notify: Sends Telegram message for each new alert
- Cache: Stores item hashes to avoid duplicate notifications
RSS Feed Format
CamelCamelCamel RSS includes:
- title: Product name + price info
- link: Direct link to Amazon product
- description: Price details and historical context
- pubDate: When the alert was generated
Customization
Check Frequency
Adjust the cron schedule (6th field in cron expression):
0 */4 * * *→ every 4 hours0 */1 * * *→ every hour0 */6 * * *→ every 6 hours
Notification Format
Edit the notification script to customize the Telegram message format.
Troubleshooting
No notifications:
- Check that the feed URL is valid (test in browser)
- Verify cron job is running:
cron --action list - Check
/tmp/camelcamelcamel/cache.jsonexists - Clear cache to re-trigger alerts
Duplicate notifications:
- Cache file may have been corrupted; delete and restart
Feed fetch errors:
- Test the URL directly:
curl https://camelcamelcamel.com/alerts/YOUR_ID.xml - Ensure internet connectivity