Price Watcher

通过本地关注列表监控商品 URL 的价格变动。无需 API 密钥。

技能位置

~/.openclaw/workspace/skills/price-watcher/

所有脚本均使用 SKILL_DIR（即 scripts/ 的父目录）来解析 watchlist.json 文件路径。

核心工作流

添加待监控商品

# 自动从网页抓取当前价格
python3 scripts/add_product.py "https://www.amazon.com/dp/BXXX"

# 显式指定价格与商品名称（当自动抓取失败时使用）
python3 scripts/add_product.py "https://..." 49.99 "Product Name"

检查全部商品价格

python3 scripts/check_prices.py

将结果以 JSON 格式输出至标准输出，并更新 watchlist.json 中的价格与时间戳字段。

筛选显著变动

python3 scripts/check_prices.py | python3 scripts/compare.py
python3 scripts/check_prices.py | python3 scripts/compare.py --threshold 10

默认阈值为 5%。无论设定何种阈值，抓取错误（fetch errors）和未找到价格（no-price results）均会被强制显示。

格式化为 Markdown 提醒

python3 scripts/check_prices.py | python3 scripts/compare.py | python3 scripts/format_alert.py

生成一份 Markdown 报告，其中包含 📉 降价、📈 涨价 和 ⚠️ 错误信息。

关注列表格式

watchlist.json（位于技能根目录）存储一个对象数组：

{
  "url": "https://...",
  "name": "Product Name",
  "baseline_price": 49.99,
  "last_price": 44.99,
  "last_checked": "2024-03-15T14:00:00+00:00",
  "price_history": [{"price": 49.99, "date": "..."}]
}

完整示例请参见 assets/watchlist.example.json。

定时任务配置

关于 cron 配置、阈值调优及反爬虫注意事项，请查阅 references/setup-guide.md。

错误处理

• fetch_error：页面无法获取（如返回 503、超时或网络异常）
• no_price：页面加载成功但未找到价格 —— 请检查目标网站页面结构是否已变更
• 上述两类状态均会在 compare.py 输出以及 format_alert.py 结果中体现，且不受阈值参数影响
• 若 add_product.py 未能自动提取价格，且用户也未手动提供价格，则该脚本将退出并返回错误