# CnpjDeltaBR — Monitor de Mudanças Cadastrais CNPJ (`joaosbp/cnpj-delta-monitor-br`) Actor

Monitore CNPJs e receba apenas o que mudou na Receita Federal: situação cadastral, capital, entrada/saída de sócios (QSA), CNAEs, porte, endereço e razão social. Snapshot + diff entre execuções, fontes keyless com fallback. Ideal para KYC, compliance e crédito.

- **URL**: https://apify.com/joaosbp/cnpj-delta-monitor-br.md
- **Developed by:** [João Victor](https://apify.com/joaosbp) (community)
- **Categories:** Business, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## CnpjDeltaBR — Monitor de Mudanças Cadastrais CNPJ

**Monitore CNPJs e seja avisado quando algo muda no registro da Receita Federal** — situação cadastral, capital social, entrada/saída de sócios (QSA), CNAEs, porte, endereço, razão social. O Actor guarda o estado anterior e emite **apenas o que mudou**, pronto para virar alerta em planilha, Slack ou SIEM de compliance.

### O que ele detecta

| Tipo | Exemplo real |
|---|---|
| `CAMPO_ALTERADO` | Situação: ATIVA → SUSPENSA; Capital: R$ 1 mi → R$ 5 mi; mudança de endereço/sede |
| `SOCIO_ENTROU` / `SOCIO_SAIU` | Novo sócio "FULANO DE TAL" (Administrador) entrou no QSA |
| `CNAE_ADICIONADO` / `CNAE_REMOVIDO` | Empresa adicionou atividade econômica nova |
| `BASELINE` | Primeira vez que o CNPJ é visto — estado atual registrado |

### Como usar

Entrada mínima — só os CNPJs (com ou sem pontuação):

```json
{
  "cnpjs": ["33.000.167/0001-01", "00.000.000/0001-91"]
}
```

**Modo recomendado: agende diariamente.** Na 1ª execução cada CNPJ vira BASELINE; da 2ª em diante o Actor emite só as mudanças — perfeito para KYC contínuo, onboarding de fornecedores, cobrança e monitoramento de cadeia.

#### Por que não só consultar quando precisar?

Consulta pontual (lookup) diz *como está*. Este Actor diz *o que mudou e quando* — mudança de situação para BAIXADA/SUSPENSA e troca de sócios são exatamente os sinais que times de compliance e crédito precisam pegar cedo, sem consultar manualmente centenas de CNPJs por dia.

### Saída

Uma linha por mudança: `cnpj`, `razaoSocial`, `tipoMudanca`, `campo`, `valorAnterior`, `valorAtual`, `detectadoEm`, `fonteDados`. Exporta em JSON/CSV/XLSX pelo botão Export.

### Fontes e limitações (declaradas)

- **Fontes:** BrasilAPI e MinhaReceita — espelhos comunitários **gratuitos e sem chave** dos dados abertos CNPJ da Receita Federal. Se a primária falha, o Actor faz fallback automático na segunda (mesmo esquema).
- **Atualização:** os dados abertos CNPJ são publicados pela Receita em lotes mensais; mudanças recentíssimas podem levar algumas semanas para aparecer. O Actor detecta o delta no dia em que a fonte reflete a mudança.
- **Não faz:** consulta de CNPJ inexistente (retorna "não encontrado"), certidões em PDF, ou dados restritos (imóveis, faturamento).
- **Polidez:** 0,4s entre consultas; retries com backoff exponencial. Erros transitórios não derrubam o run.

### Custos

Uma execução com ~100 CNPJs leva cerca de 1 minuto (~US$ 0,01 de compute). No plano FREE da Apify dá para monitorar centenas de CNPJs diariamente sem custo.

### Integrações

Funciona com Zapier/Make/Google Sheets/Slack — agende o Actor e conecte o dataset ao seu canal de alertas. Complementa o **cnpj-enrichment-lookup-br** (enriquecimento pontual) e o **ComplianceBR** (sanções): juntos formam um pipeline de due diligence contínua.

### Palavras-chave

## `cnpj` `receita federal` `kyc` `compliance` `due diligence` `monitoramento` `qsa` `sócios` `situação cadastral` `mudanças` `delta` `brasil` `brasilapi`

### 🇧🇷 Suite de Dados Públicos BR / BR Public Data Suite

Este Actor faz parte de uma suite brasileira de dados públicos e jurídicos. Combine-os em pipelines:

- **LicitacoesBR** — radar de licitações PNCP (editais e vencedores): https://apify.com/joaosbp/licitacoes-pncp-br
- **CNPJ Lookup BR** — consulta CNPJ em lote com dados da Receita Federal: https://apify.com/joaosbp/cnpj-enrichment-lookup-br
- **CnpjDeltaBR** — monitor de mudanças cadastrais de CNPJs: https://apify.com/joaosbp/cnpj-delta-monitor-br
- **ComplianceBR** — screening de sanções CEIS/CNEP/CEPIM: https://apify.com/joaosbp/cnpj-sanctions-screening-br
- **Contact Scraper BR** — emails, WhatsApp + enriquecimento CNPJ: https://apify.com/joaosbp/website-contact-finder-br
- **PrazoBR** — extrator de prazos e obrigações jurídicas: https://apify.com/joaosbp/legal-deadlines-extractor-br
- **AutosTimeline BR** — cronologia de autos e pendências: https://apify.com/joaosbp/case-timeline-builder-br
- **PublicaBR** — monitor de publicações processuais (DataJud/CNJ): https://apify.com/joaosbp/publicacoes-processuais-br
- **EditalBR** — extrator de editais de concurso em PDF: https://apify.com/joaosbp/edital-extractor-br
- **Pricing Monitor BR** — monitor de páginas de preço SaaS: https://apify.com/joaosbp/competitor-pricing-page-monitor

**Pipeline sugerido:** LicitacoesBR encontra editais → CNPJ Lookup enriquece o vencedor → ComplianceBR verifica sanções → CnpjDeltaBR monitora mudanças cadastrais.

# Actor input Schema

## `cnpjs` (type: `array`):

Lista de CNPJs — com ou sem pontuação (00.000.000/0001-91). Aceita também string separada por vírgula. Duplicados são removidos automaticamente.

## `incluirBaseline` (type: `boolean`):

Ligado (recomendado): a primeira vez que um CNPJ é visto gera uma linha BASELINE com o estado atual (situação, capital, nº de sócios). Mudanças reais aparecem a partir da 2ª execução.

## `maxCnpjs` (type: `integer`):

Teto de segurança sobre a lista de entrada.

## Actor input object example

```json
{
  "cnpjs": [
    "33.000.167/0001-01",
    "00.000.000/0001-91"
  ],
  "incluirBaseline": true,
  "maxCnpjs": 100
}
```

# Actor output Schema

## `datasetItems` (type: `string`):

Uma linha por mudança: cnpj, razão social, tipo (CAMPO\_ALTERADO, SOCIO\_ENTROU, SOCIO\_SAIU, CNAE\_ADICIONADO, CNAE\_REMOVIDO, BASELINE), campo, valor anterior → valor atual, timestamp.

## `resultsCsv` (type: `string`):

Export pronto para planilha — filtre por tipo de mudança para alertas de KYC/compliance.

## `summary` (type: `string`):

CNPJs consultados/encontrados, baselines, mudanças detectadas, sem-mudança, fallbacks de fonte e retries.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "cnpjs": [
        "33.000.167/0001-01",
        "00.000.000/0001-91"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("joaosbp/cnpj-delta-monitor-br").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "cnpjs": [
        "33.000.167/0001-01",
        "00.000.000/0001-91",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("joaosbp/cnpj-delta-monitor-br").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "cnpjs": [
    "33.000.167/0001-01",
    "00.000.000/0001-91"
  ]
}' |
apify call joaosbp/cnpj-delta-monitor-br --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=joaosbp/cnpj-delta-monitor-br",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/FrWps1bVQgqqLZ5r6/builds/SCWdbeAjfs38aCt0Q/openapi.json