Ecommerce Price Watcher

核心功能

Ecommerce Price Watcher 是一款轻量级价格监控工具，支持两种工作模式：URL直追模式 和 商品查询模式。用户可直接输入商品链接监控特定页面，也可通过自然语言描述（如"iPhone 13 128GB 智利"）自动发现商品链接并批量添加监控。

显著优点

1. 灵活的监控触发机制：支持降价检测（current < previous）和目标价达成（current ≤ target）双重警报条件
2. 结构化输出：返回标准JSON格式的警报载荷，包含商品标题、新旧价格、降幅百分比、直达链接和时间戳，便于接入Telegram/WhatsApp/Discord等通知渠道
3. 多层解析策略：采用JSON-LD → Open Graph/meta → 正则回退的层级解析，优先选取最低有效价格，适配不同电商站点
4. 安全沙箱设计：仅接受http/https协议，强制请求超时和响应体大小限制，不执行远程JavaScript，不存储API密钥

潜在局限

• 反爬虫限制：部分电商站点会拦截机器人请求（403错误），这是预期行为
• 解析覆盖率：价格提取为尽力而为，复杂站点可能需要逐步添加特定适配器
• 无内置持久化：价格历史依赖外部存储，需用户自行配置调度（建议30-120分钟cron任务）

适合人群

• 比价敏感型消费者
• 电商运营/采购人员需批量监控竞品价格
• 希望自建自动化价格警报系统的开发者

常规风险提示

工具本身不执行敏感操作，但依赖外部网页内容解析，存在页面结构变更导致提取失败的风险。建议配合--trusted-only限制可信域名以降低恶意链接风险。

核心用法

Ecommerce Price Watcher 是一款轻量级电商价格监控工具，专注于帮助用户追踪多平台商品价格变动。核心工作流分为三步：添加监控目标（支持直接 URL 或自然语言商品查询）、定期执行价格检查、生成可自动推送的降价警报。

URL 模式：直接绑定商品链接，设置目标触发价（如 399990 CLP），系统按既定频率抓取页面解析当前价格。Item 模式更具灵活性——用户输入"iPhone 13 128GB Chile"等自然语言查询，工具通过 DuckDuckGo 搜索发现候选商品链接，经可信域名过滤后批量加入监控列表。两种模式均支持历史价格追踪与 JSON 格式警报输出，便于接入 Telegram、WhatsApp、Discord 等通知渠道。

价格解析采用三层降级策略：优先提取 JSON-LD 结构化数据，其次读取 Open Graph/Meta 标签，最后以正则表达式兜底。遇到多价格场景时自动选取最低有效值作为当前报价。

显著优点

• 零依赖安全基线：纯 Python 标准库实现（urllib/json/re/pathlib），彻底规避 npm/pip 供应链攻击面
• 防御性网络设计：强制 12 秒超时、2MB 响应体限制、HTTP(S) 协议白名单、自定义 User-Agent，拒绝执行远程 JavaScript
• 隐私优先架构：所有监控数据本地 JSON 存储（~/.openclaw/state/price-watcher/），无云端上传、无 API 密钥硬编码
• 灵活触发机制：同时支持百分比降价检测与绝对价格目标命中，满足折扣猎手与预算敏感型用户双重需求
• 自然语言入口：Item-query 模式降低使用门槛，无需手动复制粘贴 URL

潜在局限

• 反爬对抗：部分电商站点（如 Falabella、Ripley）对自动化请求返回 403，需用户自行评估监控可行性
• 解析脆弱性：正则兜底策略可能因页面改版失效，长期维护需持续迭代替换 store-specific adapter
• T3 来源信任：本地个人开发者项目，无 GitHub 溯源与版本签名，代码变更透明度有限
• 明文存储风险：价格历史以未加密 JSON 持久化，多用户共享设备场景存在信息泄露隐患
• 无分布式调度：依赖 cron 等外部定时任务，高频率监控（<30 分钟）易触发目标站点限流

适合人群

• 跨境/本地电商比价用户（尤其智利市场，内置 Falabella、Paris、Ripley 等域名白名单）
• 预算敏感型消费者，需对特定商品设置心理价位提醒
• 技术爱好者，希望通过 JSON 警报接入自建通知工作流
• 隐私极客，拒绝将购物清单托管至第三方 SaaS 服务

常规风险

1. IP 封禁风险：高频请求可能被电商平台识别为爬虫，建议配合 30–120 分钟间隔及 --trusted-only 白名单使用
2. 价格解析偏差：促销标签、捆绑销售、会员价等特殊场景可能导致误报或漏报
3. 链接失效：商品下架或 URL 结构调整会造成监控中断，需定期人工复核
4. 时区/货币陷阱：跨时区价格更新与多货币站点需用户自行校验货币符号一致性