价格监控器

概述

基于 agent-browser 的自动化价格与内容监控能力。可跟踪任意网站上的价格变动、库存状态及页面内容更新，并支持可配置的告警机制与历史记录日志。

快速开始

# 监控某商品价格
agent-browser open "https://example.com/product/123"
agent-browser snapshot -i
agent-browser get text @e1  # 获取价格元素文本

核心工作流

1. 单商品价格检查

使用场景： 查询指定商品当前价格

# 导航至商品页面
agent-browser open ""

# 获取页面快照以定位价格元素
agent-browser snapshot -i

# 提取价格（请根据快照中生成的 ref 使用对应标识符，如 @e1）
agent-browser get text @e1

# 可选：保存至历史日志
echo "$(date), $(price)" >> price-history.csv

2. 多商品监控

使用场景： 跨多个商品或竞品站点进行价格追踪

创建一个 products.csv 文件，包含 URL 和对应的价格选择器：

url,selector,name
https://site-a.com/product1,.price-tag,Product A
https://site-b.com/item2,#price,Product B

运行监控脚本：

python scripts/monitor_prices.py products.csv

3. 库存/现货告警

使用场景： 商品由缺货变为有货时触发通知

agent-browser open ""
agent-browser snapshot -i
agent-browser get text @e1  # 检查是否显示 “In Stock” 或 “Out of Stock”

4. 价格历史追踪

使用场景： 构建历史价格数据用于分析

脚本自动记录以下字段：

• 时间戳
• 商品名称 / URL
• 当前价格
• 库存状态

输出格式：CSV 文件（price-history.csv）或 JSON 格式

脚本

monitor_prices.py

主监控脚本，具备以下功能：

• 从 CSV 文件读取商品列表
• 依次访问每个 URL
• 使用 CSS 选择器提取价格
• 带时间戳记录结果
• 检测价格变化
• 可选：在发生显著变化时发送告警

用法：

python scripts/monitor_prices.py products.csv [--alert-threshold 10]

参数说明：

• products.csv —— 包含 URL 与选择器的商品列表文件
• --alert-threshold —— 触发告警的价格变动百分比阈值（默认：10%）

配置

商品列表格式（CSV）

url,selector,name,min_price,max_price
https://amazon.com/dp/B08N5WRWNW,.a-price-whole,Sony Headphones,50,150
https://bestbuy.com/site/12345,.priceView-hero-price,TV,200,500

告警选项

• 邮件告警 —— 配置 SMTP 参数
• Discord webhook —— 向 Discord 频道推送消息
• 文件日志 —— 追加写入 CSV / JSON 文件
• 控制台输出 —— 在终端打印变更信息

最佳实践

1. 限频控制 —— 请求之间添加延迟（建议 ≥30 秒）
2. 异常处理 —— 对页面加载失败等情况做容错处理
3. 选择器稳定性 —— 使用稳定的 CSS 选择器，避免依赖动态生成的 class 名称
4. 无头模式 —— 自动化运行时启用浏览器无头模式
5. 合理调度 —— 建议在目标网站营业时段内执行检查以保障数据准确性

示例：每日价格检查 Cron 任务

# 每天上午 9 点执行
0 9 * * * cd /path/to/skill && python scripts/monitor_prices.py products.csv

故障排查

• 未找到元素：重新运行 agent-browser snapshot -i 获取最新元素引用
• 价格格式异常：调整 CSS 选择器，或使用正则表达式解析文本
• 页面加载超时：增加超时时间，或添加显式等待条件
• 被目标网站拦截：增加请求间隔、轮换 User-Agent，或使用住宅代理（residential proxy）