用途：Shopping 用于跨零售商零售商品数据查询。它基于 LemmeBuyIt 聚合零售 API（覆盖 70 多家零售商），并增加本地 SQLite 存储，适合先同步一次、再对本地数据做大量复合查询的场景，主要服务代理商式自动化调用。
主要能力：compare 按 UPC/EAN/GTIN/ASIN 找出同步零售商中最便宜的渠道；deals 做折扣、价格上限、评分、库存的复合筛选并排序；arbitrage 按亚马逊转售的 ROI 与买入价排序；price-drops 排行近一周或 N 周跌幅；leaderboard 汇总零售商与品类的平均折扣；index 同步商品与价格历史；watch status 追踪目标商品与目标价格。支持 --json/--select，具离线搜索与类型化退出码。
使用方式：先安装 CLI，npx -y @mvanhorn/printing-press-library install shopping --cli-only，再用 shopping-pp-cli --version 验证，确保安装目录在 PATH。备选 Go 安装：go install github.com/mvanhorn/printing-press-library/library/commerce/shopping/cmd/shopping-pp-cli@latest。鉴权用 LemmeBuyIt API key（X-API-Key，或 shopping-pp-cli auth set-token <key>），免费 key 覆盖 /shopping/ 商品面，付费 key 解锁完整搜索、周价格历史、Amazon ASIN 历史及套利数据。可用 shopping-pp-cli doctor 验证。支持 --agent 展开为 --json --compact --no-input --no-color --yes，支持 --deliver 输出到 stdout、file:<path>、webhook:<url>，支持命名 profile 与 feedback 本地记录。
适用场景：需要快速回答“哪个零售商最便宜”、筛选高折扣且库存商品、排行周降价、评估 FBA 转售利润等跨零售商任务。
限制：这是只读数据 API，不能下单、加购物车或结账，也不适合非零售数据或单一零售商订单管理。基于本地存储的查询反映上次 index 同步，不是实时货架价。部分能力依赖付费 key。价格、收费与更多平台细节暂未提供。