Preisrunter Grocery Search

核心用法

Preisrunter 是一个面向奥地利（AT）和德国（DE）的食品杂货价格聚合 API。用户通过简单的 HTTP 请求即可搜索特定商品在各连锁超市的实时价格、促销状态及规格信息，无需注册或 API 密钥。

典型查询场景：

• 日常采购比价：输入商品名（如 butter、milch），返回 Billa、Spar、Hofer、Lidl 等超市的当前售价
• 促销追踪：开启 onlySale=true 筛选正在打折的商品
• 区域精准搜索：通过 region=de 切换德国市场数据
• 单店过滤：使用 shops 参数限定特定零售商，支持多店组合查询

显著优点

• 零配置接入：无需 API key、OAuth 或身份验证，curl 即可调用
• 覆盖主流商超：整合 Billa、Spar、Hofer、Lidl、DM、Müller 等奥地利德国核心零售渠道
• 实时促销同步：productSale 字段直接标注折扣状态，productLink 指向原始详情页便于交叉验证
• 轻量输出结构：JSON 格式包含价格、规格、单位、渠道四维关键信息，便于脚本化处理

潜在局限与风险

• 速率限制隐患：文档明确提示 HTTP 429 风险，高频自动化查询可能触发封禁
• 单点依赖：数据完全依赖 Preisrunter 上游聚合，若其抓取逻辑变更或网站改版，API 可能失效
• 404 无结果处理：空结果返回 HTTP 404 而非空数组，需调用方特殊处理异常状态码
• 地域局限：仅限 AT/DE，不覆盖瑞士或其他德语区市场

适合人群

• 奥地利/德国华人家庭日常采购规划者
• 跨境代购或比价博主需追踪两地超市促销动态
• 开发者构建本地化省钱助手类应用

常规风险提示

该 API 属于第三方数据抓取封装层，非超市官方接口。价格更新存在延迟（通常数小时至一天），大宗采购或限时秒杀建议仍以门店实际标价为准。productLink 跳转的 Preisrunter 页面含广告及联盟营销代码，长期依赖需关注其商业模式可持续性。

核心用法

Preisrunter Grocery Search API 是一个纯文档型的价格查询技能，旨在帮助用户快速获取奥地利和德国地区的超市商品价格与促销信息。用户无需申请API密钥，直接通过封装好的接口即可查询。

基础查询流程：
1. 使用 https://api.preisrunter.net/wrapper/openclaw-v1/products/ 作为基础端点
2. 通过 q 参数指定搜索关键词（如"butter"、"milch"等）
3. 可选使用 region 参数切换奥地利(at)或德国(de)区域
4. 通过 onlySale=true 筛选仅促销商品
5. 使用 shops 参数指定特定超市连锁店（如billa, spar, lidl等）

典型使用场景：

• 日常采购前比价：输入商品名称快速获取各超市实时价格
• 促销挖掘：启用 onlySale 参数发现当前打折商品
• 精准筛选：组合使用区域+店铺参数，定位附近门店优惠

显著优点

零门槛接入：无需注册账号或申请API密钥，打开即用，极大降低了使用门槛。

覆盖主流商超：支持Billa、Spar、Lidl、Hofer、Penny、DM、Müller等奥地利和德国主流连锁超市，数据源全面。

实时促销追踪：productSale 字段直接标识促销状态，配合 onlySale 筛选器可高效挖掘限时优惠。

结构化输出清晰：返回字段包含商品名称、规格、单价、销售渠道、价格、促销状态及详情链接，信息完整且易于解析。

区域灵活切换：一键切换奥地利/德国市场，满足跨境购物或两地用户的需求。

潜在缺点与局限性

地域受限：仅支持奥地利和德国市场，无法覆盖瑞士、荷兰等其他德语区国家或欧盟其他国家。

数据源单一：完全依赖Preisrunter平台的数据更新频率和质量，若上游数据延迟或缺失，查询结果会受影响。

无历史价格追踪：API仅返回当前价格快照，不支持价格趋势分析或历史最低价提醒功能。

速率限制风险：上游API可能对高频请求返回HTTP 429错误，不适合大规模批量查询或价格监控脚本。

搜索精度依赖关键词：与电商平台不同，该API的模糊匹配能力有限，生僻或拼写变体可能导致404无结果。

适合的目标群体

• 在奥/德生活的华人用户：需要快速了解当地超市物价，语言障碍下高效获取商品信息
• 精打细算的家庭采购者：定期比价、追踪促销，优化每月食品支出
• 跨境购物者：往返奥地利德国之间，需要对比两地价格差异
• 小型餐饮经营者：需要批量查询原料价格，控制采购成本
• 价格敏感型消费者：对特定品牌或商品有长期价格追踪需求

使用风险与注意事项

网络依赖风险：该技能完全依赖外部API可用性。若 api.preisrunter.net 服务中断或域名变更，功能将失效。建议定期检查端点状态。

隐私泄露风险：虽然Skill本身不收集敏感信息，但用户的搜索关键词会明文传输至Preisrunter服务器。应避免在搜索词中包含个人健康信息、精确位置等隐私数据。

数据准确性风险：价格数据来源于Preisrunter的抓取或合作超市提供，可能存在滞后或错误。重要采购决策建议通过 productLink 访问原页面二次确认。

来源可信度：该Skill由个人开发者(davidus05)维护，非企业级项目。虽然当前版本安全，但长期维护和更新稳定性存在不确定性，建议关注官方渠道的版本更新动态。

合规使用：需遵守Preisrunter的使用条款，避免高频自动化爬取导致IP被封禁。合理控制请求频率，建议单次查询间隔不低于数秒。