Stripe Relatórios

Relatórios de receita, MRR e churn da Stripe direto dentro do Claude Code, sem abrir o dashboard e sem mexer em nada na sua conta. Tudo é somente leitura: o plugin consulta a API da Stripe, calcula as métricas e devolve uma análise clara em português.

O que faz

O Stripe Relatórios transforma o Claude Code em um analista financeiro que lê a sua conta Stripe e responde perguntas de negócio com números reais. Ele foi desenhado para times pequenos que precisam acompanhar a saúde da receita recorrente sem montar um BI completo.

Com ele você consegue, por exemplo:

• Calcular o MRR (receita recorrente mensal) atual e a variação em relação ao período anterior.
• Estimar o churn de assinaturas (cancelamentos no período) e a receita perdida.
• Acompanhar a receita bruta e líquida, descontando reembolsos e disputas.
• Estimar o LTV (valor do tempo de vida do cliente) a partir do ticket médio e do churn.
• Listar assinaturas ativas, em teste (trial), pausadas e canceladas.
• Auditar reembolsos recentes e entender o impacto no caixa.

O plugin nunca cria, altera ou cancela cobranças, assinaturas ou clientes. Ele só lê.

Instalação

1. Garanta que o Claude Code está instalado e atualizado.
2. Copie a pasta stripe-relatorios/ para o diretório de plugins do seu projeto (por exemplo .claude/plugins/).
3. Defina a variável de ambiente com a sua chave restrita e somente leitura da Stripe (veja a seção Configuração).
4. Reinicie a sessão do Claude Code. Os comandos /relatorio-mrr e /analisar-assinaturas ficarão disponíveis.

Para conferir se foi reconhecido, rode /relatorio-mrr sem argumentos e veja se ele pede um período.

Comandos disponíveis

• /relatorio-mrr [período] — Monta um relatório fechado de um mês ou intervalo: MRR no início e no fim, novas assinaturas, upgrades, downgrades, churn, receita bruta, reembolsos e receita líquida. Inclui uma análise narrativa do que mudou.
• /analisar-assinaturas [filtro] — Lista e analisa as assinaturas recentes (ou as que batem com um filtro), destacando trials prestes a converter, assinaturas em risco e reembolsos relevantes do período.

Configuração

O plugin usa apenas uma variável de ambiente, com o nome abaixo:

• STRIPE_API_KEY — chave de API da Stripe.

Recomendação importante de segurança: use uma chave restrita (restricted key) com permissão somente de leitura. No dashboard da Stripe, em Developers → API keys → Create restricted key, conceda acesso Read para os recursos Charges, Subscriptions, Invoices, Customers, Refunds e Balance transactions, e deixe todo o resto como None. Nunca use a chave secreta principal (full access) com este plugin — ele não precisa de permissão de escrita para nada.

Nunca cole o valor da chave em arquivos versionados nem em prompts. Defina-a no ambiente do shell ou no gerenciador de segredos do seu projeto.

Exemplo de uso

Pedindo o relatório de um mês específico:

/relatorio-mrr maio de 2026

Resposta esperada (resumida): MRR de abril vs. maio, número de novas assinaturas e cancelamentos, churn percentual, receita bruta e líquida do mês, total de reembolsos e uma análise em texto explicando os principais movimentos e uma recomendação.

Analisando as assinaturas mais recentes que estão em trial:

/analisar-assinaturas trials terminando esta semana

O plugin lista os trials próximos do fim, estima quantos tendem a converter e aponta clientes que valem um contato proativo.

Segurança e limites

• Somente leitura: o plugin não emite cobranças, não cancela assinaturas, não cria reembolsos. Se um comando parecer pedir uma ação de escrita, ele deve recusar e explicar o motivo.
• Chave restrita: use sempre STRIPE_API_KEY apontando para uma restricted key read-only. Isso limita o estrago caso a chave vaze.
• Sem dados sensíveis em texto: o plugin evita expor números completos de cartão ou dados pessoais além do necessário (nome/e-mail do cliente para identificação).
• Estimativas vs. exatos: MRR, churn e LTV são estimativas calculadas a partir da API; trate-as como indicadores de tendência, não como contabilidade fiscal oficial.
• Moeda: confira a moeda da sua conta. Se houver múltiplas moedas, peça o relatório separado por moeda para evitar somas incorretas.
• Limites de API: consultas de períodos longos paginam muitos objetos; em contas grandes, prefira intervalos mensais para não esbarrar no rate limit da Stripe.