pp-shopify 是一个面向 Shopify 店铺的终端命令行工具（CLI）技能，基于 shopify-pp-cli 二进制运行，主要用于从终端读取、导出、同步和分析 Shopify 店铺数据。它定位为只读工具，适合检查、导出、同步和分析场景，不适用于创建、更新、删除、发布、下单、发送消息等会改变远端状态的操作。
【主要能力】 该 CLI 通过 Shopify Admin GraphQL API 暴露多类数据读取能力：弃购结账（abandoned-checkouts）、客户（customers，含终身订单数与消费额）、履约订单（fulfillment-orders）、库存项目（inventory-items）以及订单（orders，含金额、财务与履约状态）、产品（products，含状态与变体库存投影）。每个资源通常提供 get（按 GraphQL ID 获取单条）和 list（列表）子命令。
此外还有作者手写的扩展命令，用于更高层的分析：bulk-operations（运行、轮询和检查 GraphQL 批量操作）；store daily-brief（基于本地数据的每日简报，含收入、热销产品、风险检查和建议行动）；store audit（依据退款、履约风险、运输异常和滞销给出健康评分）；growth campaign-brief（基于热销、VIP 和挽回机会生成活动简报）；growth winback-candidates（按终身价值对沉睡客户排序并给出挽回角度）；growth vip-segments（按消费、频率和最近购买对高价值客户分群）；ops fulfillment-risk（找出超过阈值的未完成履约订单）；ops shipping-anomalies（从同步的运输行中发现免费/缺失/高额运费）；merchandising bundle-opportunities（依据共同购买提升度与置信度建议捆绑）；merchandising dead-stock-actions（将无近期销售的库存转为降价/捆绑行动）；merchandising launch-brief（基于本地证据为产品构建发布/再发布简报）。
【使用方式】 需先安装 CLI。安装方式为 npx -y @mvanhorn/printing-press-library install shopify --cli-only，默认二进制目录在 macOS/Linux 为 $HOME/.local/bin，Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin；也可用 Go 直接安装（要求 Go 1.26.6 或更新）。安装后用 shopify-pp-cli --version 验证，并确保该目录在 $PATH 中。
认证：运行 shopify-pp-cli auth setup 获取密钥的 URL 与步骤（加 --launch 可打开 URL），然后设置 export SHOPIFY_ACCESS_TOKEN="<your-key>"，或持久化到 ~/.config/shopify-pp-cli/config.toml，再用 shopify-pp-cli doctor 验证。
任意命令可加 --agent，等价于 --json --compact --no-input --no-color --yes，输出 JSON 到 stdout、错误到 stderr，且永不出交互提示。可用 --select 保留字段子集（支持点路径与数组遍历），--dry-run 预览请求，--deliver <sink> 将输出路由到 stdout、file:<path> 或 webhook:<url>。读取本地或 API 时会包裹溯源信封（meta.source 为 live 或 local）。支持本地 SQLite 离线读取；--data-source auto 会检查 sync_state 并可能有界刷新，local 从不刷新，live 直接读 API 且不改变本地存储；设置 SHOPIFY_NO_AUTO_REFRESH=1 可跳过新鲜度钩子。
还支持命名配置文件（profile save/list/show/delete），显式标志优先于 profile，profile 优先于默认值。退出码约定：0 成功、2 用法错误、3 资源未找到、4 需认证、5 API 错误、7 被限流、10 配置错误。可通过 shopify-pp-cli which "<能力描述>" 用自然语言查找匹配命令。
MCP 服务器安装：go install github.com/mvanhorn/printing-press-library/library/commerce/shopify/cmd/shopify-pp-mcp@latest，再用 claude mcp add shopify-pp-mcp -- shopify-pp-mcp 注册，claude mcp list 验证。
【限制】 该 CLI 为只读，禁止用于创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或任何改变远端状态的请求。新鲜度契约仅覆盖已注册的店铺读取路径，meta.freshness 表示当前缓存新鲜度，不保证完整历史回填或特定 API 增强。反馈默认仅本地存储（~/.local/share/shopify-pp-cli/feedback.jsonl），除非设置 SHOPIFY_FEEDBACK_ENDPOINT 且显式 --send 或开启自动发送。其他未在资料中说明的收费、价格、平台或效果信息暂未提供。