SuperAPI AI 工具集

product-price-monitor

办公与效率

查看项目

更新于 10-15 12:45

技能介绍

Product Price Monitor 是一个价格监控技能,用于对某个具体可购买的项目进行持续监视,并在满足归一化的含税总价或可用性条件时发出提醒。它能显式处理变体、税费、手续费、货币、库存、退订条款和重复警报。设置阶段在前台运行一次,重复检查则作为 cronjob 定时触发。

用途

适合用于持续跟踪价格或可用性,例如:

  • “当这台笔记本降到 1000 美元以下时提醒我。”
  • “监视这些航班,票价低于 500 美元时通知我。”
  • “当这家酒店有可退款房型时告诉我。”
  • “跟踪门票/房源的可用性。”

当某个已存在的价格监视触发 cron tick 时(步骤 4-6),也使用该技能。

不适用:一次性的“现在多少钱”查询(应直接使用 web_search/web_extract)。

使用方式 — 设置(前台,一次)

  1. 定义确切的项目

记录来源 URL/提供方、可用的产品/房源 ID、变体、数量、地点、日期、旅客/住客、会员或登录假设、成色、卖家以及可接受的替代品。完成标准是两个变体不会被混淆。

  1. 定义警报条件

指定货币、含税总价还是税前价、最高价格、可用性/库存规则、运费、可退款性、舱位/房型/票档、冷却时间和通知目的地。完成标准是用合成示例可做出确定性的警报判断。

  1. 建立实时基线,然后调度

使用 web_extract 或 browser_navigate 获取一次有界的实时结果,记录检索时间、来源价格、费用/税费、可用性和条款。在前台抓取成功之前不要调度。将监视契约(项目、条件、基线观察)写入状态文件 ~/.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>)

选择尊重速率限制和站点条款的频率。完成标准是基线与确切的项目契约匹配,且任务已存在。

使用方式 — Tick(每次调度运行)

  1. 抓取并归一化

重新抓取来源。仅在带有时间戳汇率的情况下转换货币,并保留来源货币。区分基础价格、强制费用、运费/税费、总计和可用性。排除易变的页面元数据。抓取失败意味着状态未知:报告或跳过,但绝不能用错误页面覆盖上一次良好观察。完成标准是观察结果可与基线比较,或被明确标记为失败。

  1. 比较并抑制重复

按需在进入阈值、符合可用性、价格实质性下降或恢复时发出警报。将上一次良好观察和上一次警报指纹存入状态文件。同一报价重放不得发送第二次警报;遵守冷却时间。完成标准是警报决策相对存储状态是确定性的。

  1. 投递或保持静默

条件满足时,警报包含:确切项目/变体、观察到的含税总价与来源货币、可用性/条款、阈值、检索时间戳、来源链接以及重要不确定性。绝不能声称库存已被预留。没有符合条件的项目时保持静默——除非要求定期全清通知,否则不发送“仍在监视”的噪音。完成标准是状态文件反映本次运行。

限制与注意事项

  • 将基础票价与含税总价阈值进行比较。
  • 对错误的尺寸、卖家、舱位、日期或房型条款发出警报。
  • 用错误页面覆盖上次已知良好值。
  • 轮询过于频繁以致触发封锁或违反站点条款。
  • 在前台抓取尚未成功一次之前就进行调度。

验证

  • 监视契约锁定了项目,使两个变体不会被混淆。
  • 在创建任何任务之前,已成功完成一次前台抓取。
  • 警报决策可从状态文件确定性地重放;重复被抑制。
  • 失败的抓取从未替换上次已知良好状态。
  • 警报携带含税总价、来源货币、时间戳和来源链接。