📦 Price Monitor — 价格监控

电商竞品价格监控 自动追踪 Shopee、Lazada、Amazon 等平台的竞品价格。价格下跌即通知，生成每周对比报告，助你数据化定价。

快速开始 配置目标：告诉 agent 竞品商品 URL 与监控频率。 立即扫描：agent 访问各 URL，提取价格并记录。 获取报告：输入 price report 或 compare prices，生成清晰对比表。 设置提醒：用自然语言，如“iPhone 15 低于 RM 4,000 时提醒我”。

工作流 步骤 1：添加监控商品 用自然语言： “每 6 小时追踪这个 Shopee 商品：https://shopee.com.my/...” “把这个 Lazada 链接加入监控” “每日监控这 5 个 Amazon 商品” agent 会： 接受任意电商商品 URL 询问检查频率（默认 24h） 可选设定目标价 配置保存至 scripts/prices.json

步骤 2：价格扫描 用户触发或定时执行： 读取 scripts/prices.json 逐条访问页面，提取：商品名、现价、币种、库存、卖家 处理各平台页面结构（见 PLATFORMS.md） 结果追加到 scripts/price_history.jsonl 更新 scripts/prices.json 中的最新价 触发警报则通知用户

步骤 3：报告 即时对比（Telegram 友好）： 📊 Price Watch — 3 个商品已追踪 ─────────────────────────────── Product A → RM 89.90 ▼ 5% 较上周 Product B → RM 245.00 ▲ 2% 历史新高 Product C → RM 59.90 — 无变化

详细 CSV： 运行 python3 scripts/report.py，生成 reports/price_report_YYYY-MM-DD.csv

步骤 4：警报 自然语言设置： “iPhone 15 低于 RM 4,000 告诉我” “Product C 打折时通知” “任意商品跌幅超 15% 就提醒” “停止 Product A 的提醒” 警报存于 scripts/alerts.json，每次扫描后检查。

脚本 scripts/manage.py — 数据管理 CLI python3 scripts/manage.py products add --name "商品名" --interval 6 --alert-price 89.90 python3 scripts/manage.py products list python3 scripts/manage.py products remove python3 scripts/manage.py alerts add --product --type below --value 100.00 python3 scripts/manage.py alerts list python3 scripts/manage.py alerts remove python3 scripts/manage.py history export --days 30

scripts/report.py — 生成报告 python3 scripts/report.py # 快速摘要（stdout） python3 scripts/report.py --csv # 完整 CSV 输出到 reports/ python3 scripts/report.py --product # 单商品历史 python3 scripts/report.py --trends # 价格趋势分析

参考 平台抓取说明：references/PLATFORMS.md（Shopee 动态加载、Lazada 反爬、Amazon 结构） 配置：references/CONFIG.md（自定义间隔、通知渠道、导出格式）

最佳实践 Shopee：页面动态加载，等待 .product-price 或 [data-testid="product-price"]。 Lazada：价格分区域，检查 URL 中的 .my/.sg 等。 Amazon：价格在 #corePriceDisplay_desktop_feature_div .a-price-whole，注意优惠券另算。 频率：快销电子品 6h，稳定日用品每日。 校验：提取价格需合理，拒绝空值、零值或解析错误。