介绍
# CamelCamelCamel Alerts
自动监控您的 CamelCamelCamel RSS 订阅源以获取 Amazon 降价信息，并通过 Telegram 接收通知。
## 快速开始
1. **从 CamelCamelCamel 获取您的 RSS 订阅源 URL**： - 访问 https://camelcamelcamel.com/ 并设置价格告警 - 获取您的个人 RSS 订阅源 URL（格式：`https://camelcamelcamel.com/alerts/YOUR_UNIQUE_ID.xml`）
2. **使用您的订阅源 URL 创建一个 cron 任务**（请使用您自己的，而不是别人的！）：
```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" }' ```
**重要**：请将 `YOUR_UNIQUE_ID` 替换为您在步骤 1 中获取的订阅源 ID。每个人都有自己独特的订阅源 URL！
3. **Clawdbot 将会**： - 每 4 小时获取一次您的订阅源 - 检测新的价格告警 - 向您发送 Telegram 通知
## 工作原理
该技能使用两个组件：
### `scripts/fetch_rss.py` - 获取您的 CamelCamelCamel RSS 订阅源 - 解析价格告警条目 - 与本地缓存比对以发现新的告警 - 输出包含检测到的新条目的 JSON - 缓存条目哈希以避免重复通知
### Cron 集成 - 按照您定义的计划运行 - 触发 fetch_rss.py - 可配置为每小时、每 4 小时、每天等运行
## 设置与配置
**请参阅 [SETUP.md](references/SETUP.md)** 了解： - 如何获取您的 CamelCamelCamel RSS 订阅源 URL - Cron 配置的分步指南 - 自定义检查频率 - 缓存管理 - 故障排除
## 告警缓存
该脚本在 `/tmp/camelcamelcamel/cache.json` 处维护一个缓存，以跟踪哪些告警已被通知。这可以防止重复通知。
**清除缓存** 以重新测试通知： ```bash rm /tmp/camelcamelcamel/cache.json ```
## 通知格式
当检测到新的降价时，您将收到类似如下的 Telegram 消息：
``` 🛒 *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] ```
## 自定义
### 检查频率
调整 cron 计划（`schedule` 字段中的第 6 个参数）： - `0 * * * *` → 每小时 - `0 */4 * * *` → 每 4 小时（默认） - `0 */6 * * *` → 每 6 小时 - `0 0 * * *` → 每天
### 消息格式
编辑 `scripts/notify.sh` 来自定义 Telegram 消息的布局和表情符号。
## 技术细节
- **语言**：Python 3（仅限内置库） - **缓存**：位于 `/tmp/camelcamelcamel/cache.json` 的 JSON 文件 - **订阅源格式**：标准 RSS/XML - **依赖项**：除 Python 标准库外无其他依赖 - **超时**：每次获取订阅源 10 秒
## 故障排除
如果您没有收到通知：
1. **验证订阅源 URL** 在浏览器中是否有效 2. **检查 cron 任务** 是否存在：`cron list` 3. **手动测试**： ```bash python3 scripts/fetch_rss.py <YOUR_FEED_URL> /tmp/camelcamelcamel ``` 4. **清除缓存** 以重置： ```bash rm /tmp/camelcamelcamel/cache.json ``` 5. **检查 Telegram** 是否在 Clawdbot 中配置
有关更多详细信息，请参阅 [SETUP.md](references/SETUP.md)。