rudrankriyam/asc-revenuecat-catalog-sync

Reconciliar assinaturas e compras no aplicativo da App Store Connect com produtos, entitlements, ofertas e pacotes do RevenueCat usando o MCP asc e RevenueCat. Use ao configurar ou sincronizar catálogos de assinaturas entre o ASC e o RevenueCat.

O que é asc-revenuecat-catalog-sync?

Esta skill facilita a sincronização e reconciliação de produtos de assinatura e compras no aplicativo (IAPs) entre a App Store Connect (ASC) e o RevenueCat, utilizando os servidores MCP (Model Context Protocol) específicos de cada plataforma. Ela é útil para desenvolvedores que gerenciam catálogos de assinaturas em ambos os sistemas e precisam garantir que produtos, entitlements, ofertas e pacotes estejam consistentemente atualizados. A skill oferece funcionalidades como listar produtos da ASC e do RevenueCat, criar ou atualizar produtos e relacionamentos entre eles (ex.: associando um produto a um entitlement) e mapear identificadores de produtos entre as plataformas. O processo é baseado em etapas claras: primeiro obtém-se os dados de uma fonte (ex.: ASC), depois opcionalmente limpa-se o catálogo do RevenueCat e, por fim, aplicam-se as alterações com base em um arquivo de mapeamento ou decisões manuais. Suporta tanto o ambiente de produção quanto o sandbox, sendo indicada principalmente para o setup inicial de catálogos, migrações ou sincronizações pontuais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rudrankriyam/app-store-connect-cli-skills/tree/main/skills/asc-revenuecat-catalog-sync

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 asc e RevenueCat configurados e em execução
  • Ferramentas de linha de comando asc e revenuecat disponíveis (opcional, para verificação manual)
  • Credenciais adequadas configuradas para ambos os serviços

Capacidades

  1. Listar produtos da ASC: Obter todos os produtos de assinatura e compras no aplicativo da App Store Connect
  2. Listar produtos do RevenueCat: Obter produtos, entitlements, ofertas e pacotes atuais do RevenueCat
  3. Reconciliar: Combinar produtos da ASC com produtos do RevenueCat com base em IDs de produto ou outros critérios
  4. Criar/Atualizar: Adicionar produtos ausentes ao RevenueCat ou atualizar registros existentes
  5. 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:

  1. Mapeamento de ID de Produto: Use os IDs de produto da ASC como IDs de produto no RevenueCat
  2. Entitlements: Crie entitlements (ex.: premium, pro) e associe produtos a eles
  3. Ofertas: Agrupe produtos e pacotes relacionados em ofertas
  4. Pacotes: Crie pacotes que façam referência a produtos reais do RevenueCat

Exemplo: Sincronização Completa

  1. Liste todos os produtos de assinatura da ASC
  2. 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
  3. 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

rudrankriyam/asc-app-create-ui

Create a new App Store Connect app record via browser automation. Use when there is no public API for app creation and you need an agent to drive the New App form.

rudrankriyam/asc-aso-audit

Run an offline ASO audit on canonical App Store metadata under `./metadata` and surface keyword gaps using Astro MCP. Use after pulling metadata with `asc metadata pull`.

rudrankriyam/asc-build-lifecycle

Track build processing, find latest builds, and clean up old builds with asc. Use when managing build retention or waiting on processing.

rudrankriyam/asc-cli-usage

Guidance for using asc cli in this repo (flags, output formats, pagination, auth, and discovery). Use when asked to run or design asc commands or interact with App Store Connect via the CLI.

rudrankriyam/asc-crash-triage

Triage TestFlight crashes, beta feedback, and performance diagnostics using asc. Use when the user asks about TF crashes, TestFlight crash reports, beta tester feedback, app hangs, disk writes, launch diagnostics, or wants a crash summary for a build or app.

rudrankriyam/asc-id-resolver

Resolve App Store Connect IDs (apps, builds, versions, groups, testers) from human-friendly names using asc. Use when commands require IDs.

rudrankriyam/asc-localize-metadata

Automatically translate and sync App Store metadata (description, keywords, what's new, subtitle) to multiple languages using LLM translation and asc CLI. Use when asked to localize an app's App Store listing, translate app descriptions, or add new languages to App Store Connect.

rudrankriyam/asc-metadata-sync

Sync, validate, and apply App Store metadata with the current asc canonical metadata workflow. Use when updating metadata, localizations, keywords, or migrating legacy fastlane metadata.

rudrankriyam/asc-notarization

Archive, export, and notarize macOS apps using xcodebuild and asc. Use when you need to prepare a macOS app for distribution outside the App Store with Developer ID signing and Apple notarization.

rudrankriyam/asc-ppp-pricing

Set territory-specific pricing for subscriptions and in-app purchases using current asc setup, pricing summary, price import, and price schedule commands. Use when adjusting prices by country or implementing localized PPP strategies.

rudrankriyam/asc-release-flow

Determine whether an app is ready to submit, then drive the current App Store release flow with asc, including validation, staging, review submission, first-time availability, subscriptions, IAP, Game Center, and App Privacy checks.

rudrankriyam/asc-shots-pipeline

Orchestrate iOS screenshot automation with xcodebuild/simctl for build-run, AXe for UI actions, JSON settings and plan files, Koubou-based framing (`asc screenshots frame`), and screenshot upload (`asc screenshots upload`). Use when users ask for automated screenshot capture, AXe-driven simulator flows, frame composition, or screenshot-to-upload pipelines.

rudrankriyam/asc-signing-setup

Set up bundle IDs, capabilities, signing certificates, provisioning profiles, and encrypted signing sync with the asc cli. Use when onboarding a new app, rotating signing assets, or sharing them across a team.

rudrankriyam/asc-submission-health

Validate App Store submission readiness, submit prepared versions, and monitor review status with current asc commands. Use when shipping or troubleshooting review submissions.

rudrankriyam/asc-subscription-localization

Bulk-localize subscription and in-app purchase display names across all App Store locales using asc. Use when you want to fill in subscription/IAP names for every language without clicking through App Store Connect manually.

rudrankriyam/asc-testflight-orchestration

Orchestrate TestFlight distribution, groups, testers, and What to Test notes using asc. Use when rolling out betas.

rudrankriyam/asc-wall-submit

Submit or update a Wall of Apps entry in the App-Store-Connect-CLI repository using `asc apps wall submit`. Use when the user says "submit to wall of apps", "add my app to the wall", or "wall-of-apps".

rudrankriyam/asc-whats-new-writer

Generate engaging, localized App Store release notes (What's New) from git log, bullet points, or free text using canonical metadata under `./metadata`. Optionally pairs with promotional text updates.

rudrankriyam/asc-workflow

Define, validate, run, resume, and audit repo-local multi-step automations with current `asc workflow` and `.asc/workflow.json`, including step outputs and safe release/TestFlight workflows.

rudrankriyam/asc-xcode-build

Build, archive, export, upload, and manage Xcode version/build numbers with the current asc xcode helpers before App Store Connect upload or submission. Use when creating an IPA or PKG for upload.

Habilidades Relacionadas