SuperAPI AI 工具集

pp-revenuecat

数据与分析

查看项目

更新于 10-16 01:32

技能介绍

用途:该技能通过 revenuecat-pp-cli 二进制,为智能体或运维人员提供 RevenueCat 移动订阅状态的程序化可见性,适合收入与 MRR/ARR 快照、流失与催收分析、权益核对、退款追踪、webhook 配置审计等场景。不适用于应用内购买流程本身(那是移动 SDK)、浏览博客文档,以及 v2 尚未覆盖、仅 v1 支持的操作。

安装与验证:使用 npx -y @mvanhorn/printing-press-library install revenuecat --cli-only 安装;或用 Go 回退安装:go install github.com/mvanhorn/printing-press-library/library/payments/revenuecat/cmd/revenuecat-pp-cli@latest(需 Go 1.26.6 或更新)。验证:revenuecat-pp-cli --version,并确保安装目录在 $PATH 中。

主要能力:revenue-snapshot 输出某时点 MRR、ARR、活跃订阅、试用与收入及与上次快照的差值;mrr-trend 按周分解新增/扩展/收缩/流失;trial-funnel 展示试用转化漏斗各阶段流失;churn-watch 列出窗口内转为计费问题、宽限、过期或取消的订阅及金额暴露;dunning-alert 关联未付发票并按可挽回金额排序;entitlement-rollup 统计各权益活跃客户数并标记权益与订阅状态不一致;refund-cascade 追踪交易、退款历史与权益损失(--apply 发起退款);webhook-audit 按目标主机分组列出 webhook 集成并标记重复或陈旧。命令参考涵盖 apps、audit-logs、charts、collaborators、customers、entitlements、integrations、media-assets、metrics、offerings、packages、paywalls、products、projects、purchases、subscriptions、virtual-currencies 等分组,多数端点需对应权限。

使用方式:用 revenuecat-pp-cli which "<能力描述>" 按自然语言找命令,退出码 0 表示有匹配。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes,输出到 stdout,错误到 stderr,可用 --select 过滤字段,--dry-run 预览请求,支持 --idempotent 与 --ignore-missing。读取本地或 API 的结果包裹在 meta/results 信封中,解析 .results 与 .meta.source。

认证:在环境变量中设置 REVENUECAT_API_KEY 与 REVENUECAT_PROJECT_ID,密钥为服务端 Secret API key(Bearer 方式),只读密钥即可满足所有读取命令,可用 revenuecat-pp-cli doctor 验证。

其它:feedback 子命令将反馈本地存于 ~/.local/share/revenuecat-pp-cli/feedback.jsonl,默认不发送。命令支持 --deliver 投递到 stdout、file:<path> 或 webhook:<url>。具体收费与更多平台细节暂未提供。