O que asc-revenuecat-catalog-sync faz?
Reconciliar assinaturas e compras no aplicativo da App Store Connect com produtos, entitlements, ofertas e pacotes do RevenueCat usando os servidores MCP asc e RevenueCat. Use ao configurar ou sincronizar catálogos de assinaturas entre o ASC e o RevenueCat.
Visão Geral
Esta skill sincroniza seus dados de assinaturas e compras no aplicativo entre a App Store Connect e o RevenueCat, garantindo que seus produtos, entitlements, ofertas e pacotes estejam consistentes em ambas as plataformas.
Pré-requisitos
- Servidores MCP
asceRevenueCatconfigurados e em execução - Ferramentas de linha de comando
ascerevenuecatdisponíveis (opcional, para verificação manual) - Credenciais adequadas configuradas para ambos os serviços
Capacidades
- Listar produtos da ASC: Obter todos os produtos de assinatura e compras no aplicativo da App Store Connect
- Listar produtos do RevenueCat: Obter produtos, entitlements, ofertas e pacotes atuais do RevenueCat
- Reconciliar: Combinar produtos da ASC com produtos do RevenueCat com base em IDs de produto ou outros critérios
- Criar/Atualizar: Adicionar produtos ausentes ao RevenueCat ou atualizar registros existentes
- Mapear: Criar mapeamentos entre produtos da ASC e produtos/entitlements do RevenueCat
Fluxo de Trabalho
Etapa 1: Obter Dados da ASC
asc subscriptions list
asc iap list
Etapa 2: Obter Dados do RevenueCat
revenuecat products list
revenuecat entitlements list
revenuecat offerings list
revenuecat packages list
Etapa 3 (Opcional): Limpar Catálogo do RevenueCat
Se você estiver configurando do zero, pode ser necessário limpar produtos, entitlements ou ofertas existentes no RevenueCat.
revenuecat products delete <product-id>
revenuecat entitlements delete <entitlement-id>
Etapa 4: Criar/Atualizar no RevenueCat
Crie ou atualize produtos com base nos dados da ASC:
revenuecat products create --product-id "com.example.subscription.monthly" --store "app_store" --type "subscription"
revenuecat entitlements create --entitlement-id "premium" --lookup-key "premium"
revenuecat offerings create --offering-id "main" --name "Assinatura Principal"
revenuecat packages create --package-id "com.example.subscription.monthly" --offering-id "main" --product-id "com.example.subscription.monthly"
Mapeamento de Produtos
Use a seguinte estratégia de mapeamento para associar produtos da ASC a produtos/entitlements do RevenueCat:
- Mapeamento de ID de Produto: Use os IDs de produto da ASC como IDs de produto no RevenueCat
- Entitlements: Crie entitlements (ex.:
premium,pro) e associe produtos a eles - Ofertas: Agrupe produtos e pacotes relacionados em ofertas
- Pacotes: Crie pacotes que façam referência a produtos reais do RevenueCat
Exemplo: Sincronização Completa
- Liste todos os produtos de assinatura da ASC
- Para cada produto da ASC:
- Crie um produto correspondente no RevenueCat
- Crie um entitlement (se não existir) e associe o produto a ele
- Adicione o produto a uma oferta existente ou nova
- Verifique a sincronização comparando listas de ambos os sistemas
Notas
- Esta skill é melhor usada uma vez para a sincronização inicial do catálogo
- Para sincronizações contínuas, considere usar webhooks ou scripts automatizados
- Sempre faça backup dos seus dados do RevenueCat antes de executar operações em massa
- Teste em ambiente sandbox antes de alterar a produção