用途:按 ZIP/邮编检索 Flipp 的本地超市传单、优惠券、商家与商品,适合只读的购物研究与智能体工作流。
主要能力:flyers 浏览与列出本地传单及传单商品;items 关键词搜索传单与电商优惠;merchants 列出当地商家;basket price 将购物清单在附近商家间比价;deals scan 按折扣与紧急度排序本地优惠;expiring 查找指定天数内到期的优惠;coverage 查看哪些商家有可用传单数据;watchlist add 保存目标价并与后续同步快照比较;unit-price 按包装规格归一化单价。
使用方式:需先安装 CLI,默认二进制位于 macOS/Linux 的 $HOME/.local/bin 或 Windows 的 %LOCALAPPDATA%\Programs\PrintingPress\bin,并确保在 $PATH 中。安装:npx -y @mvanhorn/printing-press-library install flipp --cli-only;回退方案(需 Go 1.26.4+):go install github.com/mvanhorn/printing-press-library/library/food-and-dining/flipp/cmd/flipp-pp-cli@latest。验证:flipp-pp-cli --version。示例:flipp-pp-cli basket price --items milk,eggs,bread --zip 85001 --agent;flipp-pp-cli deals scan --category groceries --zip 85001 --min-discount 25 --agent;flipp-pp-cli expiring --days 3 --zip 85001 --agent。所有命令加 --agent 展开为 --json --compact --no-input --no-color --yes。可用 --select 裁剪字段,--dry-run 预览,--deliver 路由输出(stdout、file:<path>、webhook:<url>)。配置文件与凭据存于数据目录,可用 --home 或 FLIPP_HOME 等变量重定位。MCP 安装:go install github.com/mvanhorn/printing-press-library/library/food-and-dining/flipp/cmd/flipp-pp-mcp@latest,注册:claude mcp add flipp-pp-mcp -- flipp-pp-mcp。
适用场景:智能体选择购物地点、比较购物清单、跟踪临期优惠、归一化不同包装的单价。
限制:不需要认证,但为只读工具,不可下单、预约自提或处理需零售商登录的会员专属优惠;其端点为逆向网页接口,不保证是官方 API;unit-price 仅当列表含可解析数量时有效;未提供任何价格、收费或效果保证。