SuperAPI AI 工具集

iblai-vibe-monetization-analytics

数据与分析

查看项目

更新于 10-15 22:16

技能介绍

用途:在 iblai 平台上自建变现分析管理界面,包括收入卡片、平台级订阅者列表、单项订阅者下钻、付费墙总览,以及取消调用者本人订阅的自助助手。SDK 只提供数据层 hooks 和一个自助组件,没有开箱即用的分析 UI,本技能是自行组装的指南。

主要能力:useGetRevenueQuery 返回 sales_volume(字符串,需 Number() 转换)、sales_count、currency;useListSubscribersQuery 返回分页的平台级订阅者(user_id、username、email 等 12 个扁平字段);useListItemSubscribersQuery 按 (item_type, item_id) 返回更丰富的单项订阅者(约 21 字段,含 current_period_end、billing_portal_url 等);useListPaywallsQuery 返回付费墙配置(含内联 prices);useCancelSubscriptionMutation 取消调用者本人订阅。佣金比例来自 useGetStripeConnectStatusQuery 的 commission_percent,仅作展示,不用于计算净收入。

使用方式:先完成认证(/iblai-vibe-auth),配置 .mcp.json 与 iblai.env(PLATFORM、DOMAIN、TOKEN),需平台管理员角色且 enable_monetization === true,Stripe Connect 已就绪。调用前用 curl 拉取 {dm_url}/api/docs/schema/ 校验端点。取消订阅需按响应分支:有 portal_url 走 Stripe 门户,status 为 canceled 则立即完成。

限制:四个分析端点均需 IsPlatformAdmin,非管理员 403、匿名 401;收入数据来自 Stripe webhook 写入的 ItemPaymentRecord,非实时读取,存在延迟;取消端点硬绑定 request.user,无 user_id 参数,无法代他人取消,需在 Stripe Dashboard 操作;CancelSubscription 组件当前未从 @iblai/iblai-js/web-containers 导出,需复制源码使用;commission_percent 各层键不一致,应防御性遍历。验证可运行 pnpm build 并用 Playwright 截图检查。