ecommerce-price-watcher

Ecommerce Price Watcher 是一款专注于电商价格监控的自动化工具，旨在帮助用户追踪指定商品的价格变动并在达到目标价位时及时提醒。该工具采用纯 Python 标准库开发，无需额外依赖，通过命令行界面提供完整的价格监控生命周期管理。

核心用法方面，用户可通过 add 命令直接添加特定商品 URL，或使用 add-item 模式通过自然语言查询（如"iPhone 13 128GB"）自动发现候选商品链接。系统支持建立目标价格阈值，通过 check 命令定期扫描，当检测到价格下跌或触及目标价位时，生成包含商品名称、新旧价格、降幅百分比及直达链接的结构化警报。数据以 JSON 格式本地存储于 ~/.openclaw/state/price-watcher/，确保完整的价格历史可追溯。

显著优点体现在其架构设计的简洁性与安全性上。首先，仅依赖 Python 标准库（urllib、argparse 等），避免了第三方包引入的供应链攻击风险。其次，采用三层解析策略（JSON-LD、Open Graph、HTML 正则），最大限度兼容不同电商平台的页面结构。安全层面实施了严格的边界控制：仅接受 http/https 协议、强制 12 秒请求超时、限制 2MB 响应体大小，并提供 --trusted-only 选项限制可信域名，有效防范 SSRF 和恶意链接风险。所有数据本地存储，无云端上传或 API 密钥收集，充分保障用户隐私。

潜在局限性主要包括来源可信度与功能边界。作为 T3 级社区项目（openclaw 组织），缺乏顶级开源基金会或企业的官方背书。功能上，面对采用反爬虫机制（如 403 封禁）或重度 JavaScript 渲染的现代化电商页面，价格提取可能失败；部分网站需要特定适配器才能准确解析价格。此外，价格提取采用"尽力而为"策略，在复杂促销场景（如满减、会员价）下可能无法准确识别最优价格。

该工具适合追求性价比的网购用户、需要批量监控多个 SKU 的采购人员，以及希望搭建个人自动化价格监控系统的技术爱好者。对于开发者而言，其清晰的 JSON 输出格式便于集成到 Telegram、Discord 等消息平台的自动化工作流中。

使用风险方面，首要考虑的是网络行为合规性：频繁的价格检查可能对目标电商服务器造成负载，建议通过 cron 设置合理的检查间隔（30-120 分钟），避免触发反爬虫机制导致 IP 封禁。虽然工具本身不存储敏感凭证，但本地价格历史数据未加密存储，在共享设备上使用时需注意文件权限设置。此外，依赖 DuckDuckGo 进行商品发现意味着查询行为会被搜索引擎记录，对隐私极度敏感的用户应直接使用 URL 模式添加商品。