Kroger Api.Skill 是一个专为开发者设计的命令行工具，用于集成 Kroger 和 QFC（Quality Food Centers）超市的官方 API。该工具允许用户通过简单的终端命令搜索商品、管理购物车、检查提货点的库存情况，并最终创建线下自提订单。它基于 Kroger 官方提供的开发者接口构建，支持完整的购物流程自动化，适用于希望将 groceries 服务嵌入自定义应用或智能助手的场景。 该工具的核心优势在于其轻量级架构与本地状态管理。所有操作均通过 Python 脚本执行，无需依赖复杂的 Web 框架或持续的后端服务。用户的认证信息、访问令牌、当前购物车内容以及所选门店位置等数据均保存在本地的 `state.json` 文件中，确保会话的连续性和隐私安全。此外，工具内置了 OAuth 2.0 流程处理机制，可自动完成身份验证和令牌刷新，极大降低了使用门槛。 Kroger Api.Skill 特别强调对 QFC 连锁的支持，其链 ID 固定为 213，便于精准定位区域门店。无论是个人用户想要快速下单日常用品，还是开发者构建 grocery 类聊天机器人或家庭购物助手，该工具都能提供稳定可靠的底层能力支撑。整个系统围绕“搜索—加购—确认—下单”这一自然购物流程设计，逻辑清晰且易于扩展。
核心功能特点
- 支持通过关键词搜索 Kroger 和 QFC 的商品，返回包含品牌、描述和 UPC 编码的详细信息
- 提供本地购物车管理功能，可添加、查看和清空商品条目
- 能够查询指定门店的自提库存状态，判断商品是否可即时取货
- 可直接调用 Kroger 官方 API 创建线下自提订单，支持预约具体时间
- 集成 OAuth 2.0 认证流程，自动处理令牌获取与续期，保障接口调用合法性
- 兼容 grocery 列表文件输入，实现批量商品搜索与一键下单
适用场景
Kroger Api.Skill 最适合那些需要将 grocery 购物体验集成到自动化工作流中的用户。例如，家庭主妇可以在早晨通过语音指令让智能音箱‘把牛奶和面包加入 Kroger 购物车’，随后系统自动完成搜索、加购、选择附近门店并安排下午取货的全过程。这种无缝衔接的操作显著提升了生活效率，尤其适合忙碌的都市人群。 对于开发者而言，该工具是构建下一代 grocery 应用的重要组件。无论是开发一个聚合多个超市比价的移动 App，还是一个帮助视障人士语音播报购物清单的辅助系统，Kroger Api.Skill 都提供了可直接调用的命令行接口。借助其标准化的 JSON 输出格式，开发者可以轻松对接前端界面或后端服务，快速实现从商品发现到订单落地的完整闭环。 此外，在家庭共享账户或多人协作购物场景中，该工具也展现出独特价值。家长可以为孩子设置购物权限，限制其只能添加特定类别的商品；或者家庭成员之间通过共享 `state.json` 文件同步购物车状态，避免重复采购。结合 grocery-list.txt 文件，全家成员只需更新文本文件即可统一发起采购请求，极大简化了团体消费的管理复杂度。