BR Company Monitor — Mudanças Cadastrais CNPJ

Vigie uma lista de CNPJs — fornecedores, clientes, carteira de crédito — e receba alertas quando algo muda no cadastro: situação cadastral (ATIVA → BAIXADA/SUSPENSA), quadro societário (QSA), CNAE principal e secundários, razão social, nome fantasia, capital social, porte, endereço, opção pelo Simples/MEI e contato.

Fonte: minhareceita.org (projeto open-source que serve a base pública de CNPJ da Receita Federal). Sem browser, sem proxy — consumer de API estável.

💸 Modelo de cobrança no valor: a primeira verificação de cada CNPJ (baseline) é grátis. Depois, $0.002 por CNPJ verificado por execução e $0.08 por empresa com mudança detectada. Consulta que falha nunca é cobrada.

Como funciona

1. Você informa a lista de CNPJs e agenda o Actor (diário, semanal — via Schedules da Apify).
2. Cada execução consulta a base pública e compara com o snapshot da execução anterior (guardado no Key-Value Store nomeado br-company-monitor-state, na sua conta — é ele que faz o diff sobreviver entre execuções agendadas).
3. Toda empresa vira um item no dataset; as que mudaram vêm com changed: true e a lista exata de changes (campo, valor anterior, valor novo).

Monitoramento de verdade é o diff, não o cadastro — o Actor te entrega só o que mexeu.

Casos de uso

• Gestão de fornecedores / compliance — fornecedor deu baixa, foi suspenso ou trocou de sócio? Alerta na próxima execução.
• Crédito e risco — mudança de QSA, capital ou endereço na carteira monitorada.
• Customer Success B2B — cliente PJ mudou de situação cadastral = sinal de churn/risco.
• M&A / concorrência — mudanças societárias em empresas de interesse.

Input

Campo	Tipo	Descrição
cnpjs	array	Lista de CNPJs (com ou sem pontuação). Obrigatório.
maxItems	integer	Teto por execução (padrão 1000, máx 5000).
throttleMs	integer	Pausa entre consultas (padrão 300 ms — educação com a fonte pública).

Exemplo

{
  "cnpjs": ["33.000.167/0001-01", "00.000.000/0001-91"],
  "maxItems": 10
}

Output

{
  "cnpj": "33000167000101",
  "razaoSocial": "PETROLEO BRASILEIRO S A PETROBRAS",
  "situacao": "ATIVA",
  "isNew": false,
  "changed": true,
  "changesCount": 1,
  "changes": [
    { "field": "quadro_societario", "before": "…", "after": "…" }
  ],
  "enrichTip": "Perfil completo desta empresa: rode o brazilian-company-signals neste CNPJ — https://apify.com/geodetic_marigold/brazilian-company-signals",
  "url": "https://minhareceita.org/33000167000101",
  "checkedAt": "2026-07-05T12:00:00.000Z"
}

Campos vigiados no diff: situacao_cadastral, razao_social, nome_fantasia, cnae_principal, cnaes_secundarios, quadro_societario (QSA), capital_social, porte, endereco, simples, mei, telefone, email.

Funil completo (os 3 se encaixam)

1. Achar empresas por CNAE/UF/município → br-company-finder
2. Enriquecer cada CNPJ (perfil profundo: sócios, vagas, licitações, inteligência) → brazilian-company-signals
3. Vigiar a lista continuamente → este Actor.

Este monitor entrega o diff raso e recorrente — ele não substitui o enriquecimento. Quando algo muda, o item traz o enrichTip apontando o CNPJ pro passo 2.

Limites, declarados

• Frescor = cadência da base aberta. O dado reflete a última carga pública da Receita — uma baixa recente pode levar semanas para aparecer. Para decisão crítica (due diligence), confirme na fonte primária.
• Primeira aparição de um CNPJ é baseline (grátis, isNew: true) — a detecção de mudança começa na verificação seguinte.
• Falha de consulta não vira mudança. CNPJ que falhou mantém o snapshot anterior e não é cobrado.
• Dados de PJ, de fonte oficial pública. A própria base mascara CPF de sócios (faixa etária em vez de nascimento). Use para monitorar empresas, não para perfilar pessoas — LGPD vale na saída, não só na entrada.
• Não é recomendação de crédito/investimento; é encanamento de dados.

Agendamento (o jeito certo de usar)

Console Apify → Schedules → novo schedule diário/semanal apontando para este Actor com a sua lista. Integra com API, webhooks, n8n/Make e MCP (agentes de IA podem operar o monitor sozinhos).