SuperAPI AI 工具集

pp-lemonsqueezy

数据与分析

查看项目

更新于 10-16 06:50

技能介绍

用途:面向 Lemon Squeezy 的持续运营,而非一次性后台操作。适合周一收入/流失巡检、退款后禁用许可证密钥、限时促销容量跟踪、多店铺 webhook 覆盖审计。单次建产品、改折扣仍建议用网页后台。

安装:先安装 CLI 并验证。npx -y @mvanhorn/printing-press-library install lemonsqueezy --cli-only;验证 lemonsqueezy-pp-cli --version。若 npx 失败,可用 go install github.com/mvanhorn/printing-press-library/library/payments/lemonsqueezy/cmd/lemonsqueezy-pp-cli@latest(需 Go 1.26.6+)。确保安装目录在 PATH 中。

认证:在 https://app.lemonsqueezy.com/settings/api 创建 API Key,导出 LEMONSQUEEZY_API_KEY,再用 lemonsqueezy-pp-cli doctor 验证。

主要能力:revenue-snapshot 收入快照;mrr-trend 周度 MRR 趋势;churn-watch 流失监控;dunning-alert 可挽回的失败续费;license-rollup 许可证激活统计;refund-cascade 退款后级联禁用密钥;campaign-watch 折扣码兑换进度与售罄预测;webhook-audit 跨店铺 webhook 覆盖审计。另有 affiliates、checkouts、customers、discounts、files、orders、products、stores、subscriptions、usage-records、variants、webhooks 等资源的 list/get/create/update/delete 命令。

用法:命令支持 --agent(展开为 --json --compact --no-input --no-color --yes)、--select 字段筛选、--dry-run 预览、--idempotent、--ignore-missing。可用 which "<自然语言>" 查找命令。输出包裹在 meta/results 信封中,解析 .results 取数据、.meta.source 判断 live 或 local。

限制:公共 API 不支持创建产品、变体、数字文件,import 会以 resource_read_only 拒绝;此类目录设置需用 dashboard handoff 生成后台交接包。不适用于在网页应用中构建自定义结账(用官方 lemonsqueezy.js SDK)、生产环境接收 webhook、税务/VAT 报表、桌面应用面向客户的许可证校验。反馈默认仅本地存储。