RevenueCat

核心用法

RevenueCat技能提供三类核心能力：

1. 订阅指标查询：通过 /metrics 端点获取MRR（月经常性收入）、churn（流失率）、LTV等核心SaaS指标，支持图表数据导出
2. 客户数据管理：完整的CRUD操作，包括客户档案、订阅状态、购买记录、权益（entitlements）查询及虚拟货币余额
3. 文档智能检索：本地API参考文档（12个领域文件）+ 远程官方文档搜索（https://www.revenuecat.com/docs）

API采用v2版本，需通过 RC_API_KEY 环境变量认证。所有请求通过 {baseDir}/scripts/rc-api 脚本代理执行，返回JSON格式数据。

显著优点

• 官方生态深度集成：直接对接RevenueCat后端，数据实时性优于第三方聚合工具
• 领域覆盖完整：从项目配置、产品定价、offerings设计到支付墙（Paywalls）全链路支持
• 双重文档体系：结构化本地参考（按域拆分）+ 可爬取的官方文档，降低LLM幻觉风险
• 操作闭环：支持退款、取消订阅、管理URL生成等写操作，不仅限于只读分析

局限性与风险

• 单项目限制：一个API密钥仅能访问一个RevenueCat项目，跨项目分析需多密钥配置
• 密钥安全敏感：RC_API_KEY为v2 secret key，泄露可导致订阅数据篡改与资金损失
• 速率限制未明确：文档提及rate limits但未公开具体阈值，批量操作可能触发限流
• 依赖curl二进制：运行时环境必须预装curl，容器化场景需额外验证
• MIT许可证：开源协议宽松，但技能本身不包含RevenueCat官方背书

适合人群

• 移动应用产品经理/增长负责人，需监控订阅业务健康度
• 数据分析师构建自动化收入报表管道
• 开发者调试订阅状态同步问题
• 财务团队核对退款与交易记录

常规风险提示

⚠️ 密钥管理：RC_API_KEY应注入环境变量或密钥管理系统，禁止硬编码或日志输出
⚠️ 写操作确认：退款、订阅取消为不可逆资金操作，生产环境建议增加人工确认层
⚠️ 数据隐私：客户数据含设备ID、交易记录，需符合GDPR/CCPA等合规要求

核心功能

RevenueCat Skill 是一款面向订阅经济的数据分析工具，主要提供三大能力：

1. 订阅指标查询：通过 RevenueCat API v2 获取 MRR（月度经常性收入）、流失率（Churn）、客户生命周期价值等核心订阅指标
2. 客户数据管理：支持客户 CRUD、订阅状态查询、退款/取消操作、权益（Entitlements）管理等
3. 文档智能检索：内置 RevenueCat 官方文档索引，可快速定位 API 参考、集成指南和错误处理说明

显著优点

• 来源权威：RevenueCat 是业界领先的订阅管理基础设施提供商，服务超过 30,000 款应用，数据可靠性极高
• 安全顶级：纯文档型 Skill（T-MD 分类），无可执行代码，通过 CLS S+ 级安全认证，零安全风险
• 覆盖完整：涵盖 12 个核心域（Customers、Subscriptions、Products、Offerings、Entitlements、Purchases、Projects、Metrics、Paywalls、Integrations、Virtual Currencies）的完整 API 参考
• 使用灵活：支持按需加载参考文档，避免信息过载；提供本地 API 参考和远程文档搜索双通道

潜在局限

• 环境依赖：必须配置 RC_API_KEY 环境变量才能使用 API 查询功能，纯文档浏览无需密钥
• 单项目限制：单个 API Key 仅允许访问一个 RevenueCat 项目，多项目场景需切换密钥
• 功能边界：Skill 本身不执行数据处理或可视化，仅提供 API 调用能力和文档指引
• 实时性依赖：指标数据准确性取决于 RevenueCat 平台的实时同步状态

适合人群

• 移动应用开发者：需要集成或调试 RevenueCat SDK 的 iOS/Android 开发团队
• 产品经理与增长团队：需要快速查询订阅数据、分析转化漏斗的业务人员
• 财务与运营人员：需要导出 MRR、Churn 等财务指标进行对账或汇报
• 技术支持团队：需要查询客户订阅状态、处理退款或权益问题的客服人员

常规风险提示

• API 密钥安全：RC_API_KEY 属于敏感凭证，需在安全环境配置，避免硬编码或泄露
• 速率限制：RevenueCat API 存在调用频率限制，高频查询可能导致临时限流
• 数据权限：API Key 的权限范围由 RevenueCat 控制台配置决定，敏感操作（退款、取消订阅）需谨慎执行
• 合规义务：处理用户订阅数据时，需遵守 GDPR、CCPA 等数据保护法规的数据最小化原则