mcpField
P
product-price-monitor

product-price-monitor

github.com/nousresearch生产力258.1k129 次安装今天更新
代码仓库

关于 product-price-monitor

Product Price Monitor 是一项定期监控商品或可购买项目价格与库存条件的技能,供需要价格或可用性提醒的用户使用。它通过保存监控状态、规范化总价并抑制重复通知来处理周期性检查。

主要功能

  1. 01精确定义商品、规格与购买条件
  2. 02记录价格、费用、税项和库存基线
  3. 03定期获取并规范化价格信息
  4. 04按条件触发提醒并抑制重复通知
  5. 05保留最后一次有效观测

适用场景

  1. 01商品降至指定含税总价时提醒
  2. 02监控航班票价是否低于上限
  3. 03等待酒店可退款房间或票券有库存

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nousresearch/hermes-agent --skill product-price-monitor

安装后在 Claude Code 中输入/product-price-monitor确认已加载。

详细介绍

商品价格监控

监控一件具体可购买的商品,并在归一化后的含税费总价或库存状态符合条件时发出提醒。明确处理商品变体、税费、费用、货币、库存、取消条款和重复提醒。设置只需在前台运行一次;定期检查以 cronjob 任务执行(price-watch 自动化蓝图会搭建所需框架)。

适用场景

  • “这台笔记本电脑降到 $1,000 以下时提醒我。”
  • “关注这些航班,票价低于 $500 时提醒我。”
  • “这家酒店有可退款房型时告诉我。”
  • “追踪门票/商品的库存情况。”
  • 现有价格监控的 cron 任务触发时(步骤 4-6)。

不适用于:一次性查询“现在价格是多少”(直接使用 web_search/web_extract)。

流程 — 设置(前台执行一次)

1. 定义确切的商品

记录来源 URL/提供方、商品/列表 ID(如有)、变体、数量、地点、日期、出行者/宾客、会员/登录假设、商品状况、卖家和可接受的替代品。完成标准:两个变体不会混淆。

2. 定义提醒条件

指定货币、含税费总价或税前价格、最高价格、库存规则、运费、是否可退款、舱位/房型/票种、冷却时间和通知目标。完成标准:对模拟示例可以确定性地作出提醒判断。

3. 建立实时基线,然后安排任务

使用 web_extract 或 browser_exec 获取范围明确的实时结果,并记录获取时间、来源价格、费用/税费、库存情况和条款。至少成功完成一次前台抓取后才能安排任务。将监控约定(商品、条件、基线观测)写入 ~/.hermes/price-watches/<watch-slug>.json 下的状态文件,然后创建任务:

cronjob(action="create",
        schedule="every 6h",
        prompt="Load the product-price-monitor skill and run the tick for the watch contract at ~/.hermes/price-watches/<watch-slug>.json.",
        deliver=<user's destination>)

选择符合速率限制和网站条款的检查频率。完成标准:基线与确切的商品约定一致,且任务已创建。

流程 — 任务执行(每次定时运行)

4. 获取并归一化

重新获取来源数据。只有使用带时间戳的汇率换算货币,并保留来源货币。分别记录基础价格、强制费用、运费/税费、总价和库存情况。排除易变的页面元数据。获取失败表示状态未知:报告失败或跳过,但绝不能用错误页面覆盖最近一次成功观测。完成标准:观测值可与基线比较,或已明确标记为获取失败。

5. 比较并抑制重复提醒

按要求,在价格首次达到阈值、库存符合条件、价格明显降低或库存恢复时提醒。在状态文件中保存最近一次成功观测和最近一次提醒的指纹。重放同一优惠时不得再次发送提醒;遵守冷却时间。完成标准:根据已存状态可以确定性地作出提醒判断。

6. 发送提醒或保持静默

条件满足时,提醒内容包括:确切的商品/变体、观测到的含税费总价和来源货币、库存情况/条款、阈值、获取时间戳、来源链接及重要的不确定性。绝不要声称已预留库存。没有符合条件的商品时保持静默——除非用户要求定期确认无异常,否则不要发送“仍在监控”等无意义消息。完成标准:状态文件已反映本次运行结果。

常见问题

  • 将基础票价与含税费总价阈值比较。
  • 对错误的尺码、卖家、舱位、日期或房型条款发出提醒。
  • 用错误页面覆盖最近一次已知的有效值。
  • 轮询过于频繁,导致请求被拦截或违反网站条款。
  • 尚未成功完成一次前台抓取就安排任务。

验证

  • 监控约定已锁定商品,不会混淆两个变体。
  • 创建任务前已成功完成一次前台抓取。
  • 根据状态文件重放提醒判断时结果具有确定性;重复提醒已抑制。
  • 获取失败时绝不会覆盖最近一次已知的有效状态。
  • 提醒包含含税费总价、来源货币、时间戳和来源链接。

评论

支持 Markdown