revenuecat

核心用法

RevenueCat Skill 是一款专为订阅制应用开发者设计的 API 查询工具，通过与 RevenueCat 官方 API 深度集成，实现对订阅业务数据的全面掌控。用户需配置 RC_API_KEY 环境变量（v2 secret API key）后，即可调用封装好的 rc-api.sh 脚本执行各类查询操作。

该 Skill 采用模块化设计，覆盖 12 个核心领域：客户管理（Customers）、订阅状态（Subscriptions）、产品配置（Products）、套餐与权益（Offerings/Entitlements）、购买记录（Purchases）、项目设置（Projects）、业务指标（Metrics）、支付墙（Paywalls）、第三方集成（Integrations）及虚拟货币（Virtual Currencies）。每个领域均有独立的参考文档，按需加载避免资源浪费。

远程文档搜索功能支持通过 llms.txt 和 sitemap.xml 快速定位 RevenueCat 官方文档，并可直接获取 Markdown 格式内容，便于 AI 助手进行知识整合。

显著优点

官方背书，来源可信：由 RevenueCat CEO/联合创始人 jeiting 亲自维护，GitHub 组织 clawdbot 为官方关联项目，代码质量与安全性有充分保障。

功能覆盖全面：从基础的 MRR（月度经常性收入）、流失率（Churn）等核心指标，到客户级订阅详情、退款管理、权益追踪，满足订阅业务全生命周期管理需求。

安全架构严谨：采用环境变量隔离敏感凭证，HTTPS 加密通信，脚本启用 set -euo pipefail 严格模式，无危险函数或动态代码执行风险。

轻量无依赖：仅依赖系统标准工具 curl，无额外包管理负担，部署简单快捷。

潜在缺点与局限性

只读为主：当前版本主要聚焦于数据查询与文档检索，缺乏对订阅的主动修改能力（如批量退款、客户属性更新等需通过 RevenueCat 控制台完成）。

单项目限制：一个 API Key 仅绑定单个 RevenueCat 项目，多项目用户需频繁切换环境变量配置。

网络依赖性强：所有数据实时从 RevenueCat 服务器获取，离线场景无法使用，且受 API 速率限制约束。

学习成本：RevenueCat 本身的订阅模型（Offerings-Packages-Products 层级）对新手有一定理解门槛，需配合官方文档使用。

适合的目标群体

• 移动应用开发者：使用 RevenueCat 处理应用内购买（IAP）的 iOS/Android 开发团队
• 数据分析师：需要定期输出订阅业务报表、监控核心指标的产品运营人员
• 产品经理：追踪客户生命周期价值（LTV）、识别高价值用户群体的决策者
• 客户支持团队：快速查询客户订阅状态、处理退款咨询的一线支持人员

使用风险

API Key 泄露风险：v2 secret key 具有较高权限，若误提交至代码仓库或日志中，可能导致数据泄露。建议配合密钥管理服务（如 AWS Secrets Manager、1Password）使用。

速率限制影响：RevenueCat API 存在调用频率限制，高频自动化查询可能触发限流，需合理设计请求策略。

数据时效性：指标数据存在计算延迟（通常数小时），不适合实时交易监控场景。

第三方服务依赖：RevenueCat 服务端可用性直接影响 Skill 功能，需关注官方状态页面。