Preisrunter Grocery Search

核心功能

Preisrunter 是专注德语区（奥地利、德国）的食品杂货价格聚合 API，通过单一接口整合 Billa、Spar、Hofer、Lidl、REWE 等主流连锁超市的实时价格与促销数据。用户可通过商品关键词搜索，快速获取跨店价格对比、促销标记及直接购买链接。

显著优点

区域覆盖精准：专攻 AT/DE 市场，数据结构针对当地消费习惯优化，支持按国家/地区筛选。

实时促销追踪：onlySale 参数可快速过滤当前打折商品，适合规划购物清单的用户。

灵活的商家筛选：支持单店或多店组合过滤（如 billa,spar），便于对比特定零售商价格。

零门槛试用：API Key 非必需，无认证即可体验基础功能，降低了用户测试成本。

多方式鉴权：支持 Query、Header（X-API-Key/Authorization Bearer）、环境变量三种密钥传递方式，适配不同部署场景。

潜在局限

地理限制严格：仅限奥地利和德国，无法覆盖瑞士或其他欧盟国家超市数据。

速率限制风险：文档明确提及可能遭遇 HTTP 429 限流，高频调用需配合 API Key 获取更高配额。

数据完整性依赖上游：404 响应表示无结果，但不区分"暂时缺货"与"商品不存在"，误差处理需调用方自行设计。

无官方 SDK：仅提供 REST 端点，需自行封装 curl/jq 或编程语言 HTTP 客户端。

适合人群

• 在奥地利或德国生活的 price-sensitive 消费者
• 开发购物比价 App/小程序的独立开发者
• 需要批量监控特定 SKU 价格波动的社区团购组织者
• 研究德语区通胀与零售价格的学术/商业分析师

常规风险提示

API 稳定性：作为非官方 wrapper 服务，依赖 Preisrunter 主站数据抓取，存在因源站反爬策略变更导致接口不稳定的可能。

数据时效性：促销信息以 Preisrunter 抓取周期为准，极端情况下可能与门店实际标价存在数小时延迟。

隐私合规：搜索关键词可能暴露用户消费偏好，商业场景部署建议评估 GDPR 合规性。

密钥管理：虽然支持无 Key 调用，但生产环境使用 API Key 时需注意环境变量隔离，避免密钥泄露至日志或前端代码。

核心用法

Preisrunter Grocery Search API 是一款专注于奥地利（AT）和德国（DE）市场的食品杂货价格查询技能。用户可通过简单的自然语言指令，调用 Preisrunter 官方 API 获取实时商品价格、促销信息和多店比价结果。

该技能支持以下核心功能：

• 智能搜索：输入商品名称（如"黄油""牛奶""啤酒"），返回匹配商品列表
• 地区切换：默认奥地利市场，可切换至德国市场进行价格查询
• 促销筛选：启用 onlySale=true 仅显示特价商品，快速锁定折扣
• 商店过滤：支持指定超市连锁（如 Billa、Spar、Hofer、Lidl 等）进行精准筛选
• 灵活认证：API Key 为可选项，无 Key 也能使用基础功能；有 Key 可解锁更高请求配额

使用方式极为简单，用户只需描述需求（如"奥地利哪家超市牛奶最便宜""德国啤酒促销"），Agent 即可自动调用该技能完成查询并返回结构化结果，包含商品名称、规格、单价、商店、促销状态及详情链接。

显著优点

1. 权威数据源：Preisrunter 是奥地利运营多年的知名价格比较平台，数据覆盖 Billa、Spar、Hofer、Lidl 等主流连锁超市，价格信息实时可靠
2. 零门槛使用：API Key 非强制，普通用户无需注册即可体验核心功能，降低使用门槛
3. 多维度筛选：支持按地区、商店、促销状态组合过滤，满足精细化比价需求
4. 输出结构化：返回字段规范统一（价格、规格、单位、商店、促销标识、详情链接），便于后续处理或展示
5. 安全可信：纯 Markdown 文档型技能，无可执行代码，API 端点指向官方可信域名，通过全部六维安全检测

潜在缺点与局限性

1. 地域受限：仅支持奥地利和德国市场，其他国家/地区用户无法使用
2. 语言限制：搜索关键词需使用德语或英语，中文商品名可能匹配效果不佳
3. API 配额限制：无 Key 状态下存在隐式请求限制，高频查询可能触发 HTTP 429 限流
4. 依赖外部服务：数据实时性完全依赖 Preisrunter 平台，若对方服务中断或更新，本技能将失效
5. 无历史趋势：当前 API 仅返回实时价格快照，不支持价格历史走势分析或降价提醒功能
6. URL 编码要求：商店名称含空格时需手动编码（%20），对非技术用户不够友好

适合的目标群体

• 在奥/德生活的华人/留学生：需要快速了解当地超市物价，优化购物决策
• 跨境购物爱好者：经常往返奥德边境，需要对比两国同一商品价格
• 精打细算的家庭主妇/主夫：关注促销信息，希望以最低成本完成日常采购
• 价格敏感型消费者：对特定商品（如婴儿奶粉、进口食品）有长期比价需求
• 小型餐饮业主：需要批量采购食材，通过比价控制成本

使用风险

1. 网络稳定性风险：作为外部 API 依赖型技能，Preisrunter 服务器故障、网络波动或区域性限制可能导致查询失败
2. 限流中断风险：高频调用可能触发 429 限流，建议在连续查询中加入合理间隔
3. 数据时效性风险：价格数据存在同步延迟，特价商品可能出现"到店无货"或价格已变更的情况
4. 隐私合规风险：虽然技能本身不收集用户数据，但若用户通过 API Key 登录，Preisrunter 平台可能记录查询行为，建议阅读其隐私政策
5. 功能迭代风险：Preisrunter 官方 API 接口升级可能导致字段变更，需关注版本兼容性