核心用法
Preisrunter Skill 提供两套并行方案查询奥地利(AT)与德国(DE)的超市商品价格:
API Wrapper 模式(零安装)
- 直接调用
https://api.preisrunter.net/wrapper/clawdbot-v1/products/端点 - 支持参数:
q(搜索词)、region(at/de)、onlySale(仅促销) - 返回结构化JSON,包含商品名、规格、商店、价格(EUR)、促销信息及详情页链接
CLI 模式(推荐自动化场景)
- 需 Node.js 20+,通过
npm i -g @preisrunter/preisrunter-cli或npx运行 - 命令格式:
preisrunter search "关键词" --region at/de --only-sale --json - 输出可管道至
jq进行二次筛选(如按价格排序取最低)
显著优点
1. 零门槛接入:API 无需注册认证,curl 即可调用
2. 双区域覆盖:AT/DE 超市数据一站式查询
3. 促销聚焦:onlySale 参数快速锁定折扣商品
4. CLI 友好:专为 bot/agent 设计,支持 JSON 输出与 Unix 管道
5. 链接直达:返回 Preisrunter 详情页,便于人工复核
潜在局限
- 上游限流:API 存在速率限制(HTTP 429),高频率轮询需自行控制
- 404 空结果:无匹配商品时 API 返回 404,CLI 退出码 4,需容错处理
- 数据覆盖依赖:价格数据由 Preisrunter 平台聚合,非实时 POS 直连,可能存在延迟
- 地理限制:仅支持 AT/DE,其他欧盟国家不可用
- CLI 引号要求:多词搜索必须加引号,否则解析失败
适合人群
- 个人消费者:比价购物、追踪促销
- 开发者/智能体:构建价格监控 bot、自动化采购助手
- 跨境购物者:AT/DE 双区价格对比
常规风险
- 隐私:API 无需身份凭证,不收集用户数据
- 可用性:依赖第三方 Preisrunter 服务稳定性,非官方超市直连
- 价格准确性:促销信息以平台数据为准,实际结算请以门店为准