Inteligência de Mercado por CNAE — Brasil

Meça o tamanho de um mercado brasileiro por CNAE

Transforme dados abertos oficiais do CNPJ em um perfil de mercado agregado por atividade econômica.

Informe um CNAE completo ou um prefixo de 2–6 dígitos e receba, no recorte de UF escolhido:

• total de estabelecimentos;
• estabelecimentos ativos;
• novas matrizes ativas no mês;
• distribuição por UF;
• quantidade de CNAEs cobertos pelo prefixo;
• distribuição por porte das novas entrantes, quando ativada.

O Actor usa um índice mensal mantido pela JM Forge, construído a partir dos dados abertos oficiais da Receita Federal. Cada perfil informa versaoDosDados e staleness para que a fotografia usada seja auditável.

Sem scraping de site. Sem IA em runtime. Sem inventar tamanho de mercado.

Principais recursos

• Perfil agregado por CNAE
• CNAE completo de 7 dígitos
• Prefixos de CNAE de 2–6 dígitos
• Brasil inteiro ou UFs selecionadas
• Total de estabelecimentos
• Estabelecimentos ativos
• Novas matrizes ativas do mês
• Distribuição por UF
• Detalhe das novas empresas por porte
• Micro Empresa — 01
• Empresa de Pequeno Porte — 03
• Demais — 05
• Contagem de CNAEs cobertos pelo pedido
• Versão mensal dos dados
• Alerta de índice atrasado
• CNAE inexistente não é cobrado
• Mercado zero no recorte continua sendo resposta legítima
• RUN_SUMMARY gratuito
• Health checks e transparência de fonte
• Até 200 perfis por execução
• Pay Per Event por perfil entregue

Actor comunitário não-oficial. Sem afiliação com a Receita Federal do Brasil ou qualquer órgão público. A fonte de origem são os dados abertos oficiais do CNPJ. O runtime consome um índice mensal derivado desses dados e mantido pela JM Forge; preserve versaoDosDados e staleness ao armazenar os resultados.

---

Para que este Actor serve

A pergunta central é:

Qual o tamanho deste mercado, onde ele está e quantas novas empresas entraram nele no mês de referência?

Exemplos de uso:

• pesquisa de mercado;
• planejamento comercial;
• análise de TAM observável no cadastro CNPJ;
• escolha de regiões;
• inteligência de vendas;
• priorização de setores;
• análise competitiva;
• expansão geográfica;
• acompanhamento de novos entrantes;
• criação de dashboards;
• planejamento B2B.

---

Para quem é

Estratégia e inteligência de mercado

Compare setores e regiões usando uma mesma unidade de medida cadastral.

Vendas B2B

Use o perfil para decidir em quais CNAEs ou UFs vale aprofundar a prospecção.

Depois, use um Actor independente de descoberta de empresas quando precisar dos leads individuais.

Agências e consultorias

Crie relatórios mensais para nichos específicos.

Pesquisa e dados

Construa séries históricas salvando um perfil mensal por CNAE.

Automação

Conecte os perfis a:

• Apify API;
• n8n;
• Make;
• Google Sheets;
• bancos de dados;
• BI;
• dashboards;
• sistemas internos.

---

Este Actor entrega mercado agregado — não uma lista de empresas

O registro principal é:

CNAE_PROFILE

Ele representa um mercado agregado.

O Actor não entrega, neste produto:

• CNPJ individual de cada empresa;
• razão social de cada estabelecimento;
• endereço de cada empresa;
• telefone;
• e-mail;
• sócios.

Para empresas uma a uma, use os Actors independentes da família CNPJ.

---

O que entra no tamanho de mercado

totalEstabelecimentos

Conta estabelecimentos do CNAE × UF presentes no índice:

matrizes
+
filiais
+
diferentes situações cadastrais

Portanto, este campo não significa:

empresas ativas

nem:

matrizes

Ele é o estoque total de estabelecimentos da célula agregada.

---

Estabelecimentos ativos

O campo:

estabelecimentosAtivos

é a parcela ativa dentro do mesmo escopo CNAE × UF.

Use esse campo quando a pergunta for mais próxima de:

Quantos estabelecimentos ativos existem neste mercado cadastral?

---

Novas empresas do mês

O campo:

novasMatrizesAtivasNoMes

tem um recorte diferente do estoque.

Ele representa:

matriz
+
situação ativa
+
início de atividade no mês de referência

Filiais novas não entram nessa métrica.

---

Importante: porte não existe no estoque agregado

O índice de mercado principal sustenta por célula CNAE × UF:

totalEstabelecimentos
estabelecimentosAtivos
novasMatrizesAtivasNoMes

Ele não possui porte de cada estabelecimento do estoque total.

O porte é calculado somente no detalhe das novas matrizes do mês, quando:

{
  "detalharNovas": true
}

Por isso o Actor não promete algo como:

Existem 500 mil microempresas ativas neste CNAE.

Esse número não é sustentado pelo índice agregado atual.

---

Como o detalhe de porte funciona

Com o detalhe ativado, o Actor lê os registros mensais das novas matrizes no escopo e calcula:

novasDoMesDetalhe.total
novasDoMesDetalhe.porPorte

Exemplo:

{
  "novasDoMesDetalhe": {
    "total": 10374,
    "porPorte": {
      "01": 10133,
      "03": 214,
      "05": 27
    },
    "totalNoEscopoDePorte": null,
    "parcial": false
  }
}

---

Filtro de porte — atenção

O input:

portes

não altera:

totalEstabelecimentos
estabelecimentosAtivos
novasMatrizesAtivasNoMes

Ele serve para calcular:

novasDoMesDetalhe.totalNoEscopoDePorte

dentro das novas empresas detalhadas.

Exemplo:

{
  "portes": [
    "01",
    "03"
  ],
  "detalharNovas": true
}

O perfil continua representando o mercado completo do CNAE/UF.

O campo de porte mostra quantas novas entrantes pertencem aos portes selecionados.

---

Fonte dos dados

A origem é o conjunto de dados abertos do CNPJ administrado pela Receita Federal.

Página oficial de dados abertos da Receita Federal:

https://www.gov.br/receitafederal/pt-br/acesso-a-informacao/dados-abertos

O fluxo deste produto é:

dados abertos oficiais do CNPJ
        ↓
índice mensal JM Forge — RFB-INDEX
        ↓
células CNAE × UF
        ↓
CNAE_PROFILE

O Actor não precisa processar o snapshot bruto completo em cada execução.

---

Por que existe um índice mensal

A base aberta do CNPJ é grande.

Para tornar consultas agregadas rápidas, a JM Forge pré-processa a fotografia mensal em células como:

CNAE × UF

e mantém, por célula:

total
ativos
novas matrizes ativas do mês

O runtime consulta esse índice por HTTPS.

É uma dependência de dados, não outro Actor encadeado em runtime.

---

Frescor dos dados

Este produto trabalha com frescor mensal.

Ele não promete:

tempo real
atualização diária
abertura no mesmo dia

O mês usado aparece no output.

---

versaoDosDados

O índice pode retornar um bloco como:

{
  "snapshotMonth": "2026-08",
  "referenceMonth": "2026-07",
  "builtAt": "2026-08-31T23:22:20.138Z"
}

snapshotMonth

Fotografia oficial usada para construir o índice.

referenceMonth

Mês usado para a métrica de novas matrizes.

builtAt

Momento de construção do índice mensal.

---

staleness

O Actor compara o mês disponível com o mês fechado esperado no calendário brasileiro.

Exemplo:

{
  "staleness": {
    "indexMonth": "2026-07",
    "expectedMonth": "2026-07",
    "stale": false
  }
}

Se o índice estiver atrás:

stale: true

e o resumo adiciona um warning.

O dado ainda informa sua versão real; o Actor não disfarça atraso como frescor.

---

Input

Exemplo recomendado

{
  "cnaes": [
    "56",
    "6201501"
  ],
  "ufs": [
    "SP",
    "MG"
  ],
  "portes": [
    "01",
    "03"
  ],
  "detalharNovas": true,
  "mes": "",
  "maxResults": 20,
  "maxRuntimeMs": 300000
}

Campos de input

Campo	Default	Descrição
cnaes	obrigatório	CNAEs completos ou prefixos de 2–6 dígitos. Máximo 200.
ufs	[]	UFs do perfil. Vazio = Brasil inteiro.
portes	[]	Portes usados somente no detalhe das novas matrizes.
detalharNovas	true	Calcula distribuição por porte das novas matrizes.
mes	vazio	AAAA-MM; vazio = mês mais recente no índice.
maxResults	50	Máximo de perfis entregues/cobrados. Máximo 200.
maxRuntimeMs	300000	Teto de runtime.
debug	false	Logs adicionais.

---

CNAE completo

Exemplo:

{
  "cnaes": [
    "5611201"
  ]
}

Cria um perfil para o código específico.

---

Prefixo de CNAE

Exemplo:

{
  "cnaes": [
    "56"
  ]
}

Agrega todos os CNAEs presentes no escopo cujo código começa com:

56

O campo:

cnaesNaClassificacao

informa quantos códigos CNAE distintos foram encontrados dentro do escopo de UF e agregados naquele perfil.

---

Formatação de CNAE

A API aceita o CNAE numérico e também tolera pontuação/espaços usuais.

Exemplo:

5611201
5611-2/01

ambos podem representar o mesmo código normalizado.

Caracteres arbitrários ou letras não são removidos silenciosamente.

Uma entrada como:

56abc

é rejeitada em vez de virar acidentalmente:

56

---

Filtro por UF

Exemplo:

{
  "ufs": [
    "SP"
  ]
}

O perfil soma somente as células do CNAE dentro de São Paulo.

Lista vazia:

{
  "ufs": []
}

significa Brasil inteiro.

---

Porte das novas empresas

Códigos:

01 = Micro Empresa
03 = Empresa de Pequeno Porte
05 = Demais

Exemplo:

{
  "portes": [
    "01",
    "03"
  ],
  "detalharNovas": true
}

Se portes for informado e detalharNovas estiver desativado, o input é rejeitado para evitar um filtro silenciosamente ignorado.

---

Mês de referência

Mês mais recente:

{
  "mes": ""
}

Mês específico, quando ainda disponível:

{
  "mes": "2026-07"
}

O formato é validado como:

AAAA-MM

com mês entre:

01–12

---

Output

O Dataset contém:

CNAE_PROFILE
RUN_SUMMARY

CNAE_PROFILE é cobrado.

RUN_SUMMARY é gratuito.

---

Exemplo de CNAE_PROFILE

{
  "recordType": "CNAE_PROFILE",
  "cnaeSolicitado": "56",
  "tipoSolicitacao": "prefixo",
  "escopoUfs": [
    "SP"
  ],
  "cnaesNaClassificacao": 9,
  "totalEstabelecimentos": 1730020,
  "estabelecimentosAtivos": 509455,
  "novasMatrizesAtivasNoMes": 10374,
  "porUf": {
    "SP": {
      "total": 1730020,
      "ativos": 509455,
      "novasNoMes": 10374
    }
  },
  "novasDoMesDetalhe": {
    "total": 10374,
    "porPorte": {
      "01": 10133,
      "03": 214,
      "05": 27
    },
    "totalNoEscopoDePorte": null,
    "parcial": false
  },
  "escopoPortes": null,
  "versaoDosDados": {
    "snapshotMonth": "2026-08",
    "referenceMonth": "2026-07",
    "builtAt": "2026-08-31T23:22:20.138Z"
  },
  "staleness": {
    "indexMonth": "2026-07",
    "expectedMonth": "2026-07",
    "stale": false
  },
  "observedAt": "2026-08-31T23:26:22.912Z"
}

Os números acima ilustram o shape observado durante a construção do produto.

O valor real depende do mês, índice e escopo usados na execução.

---

Campos de CNAE_PROFILE

Campo	Descrição
recordType	CNAE_PROFILE.
cnaeSolicitado	CNAE ou prefixo solicitado.
tipoSolicitacao	codigo ou prefixo.
escopoUfs	UFs selecionadas ou BR.
cnaesNaClassificacao	CNAEs distintos agregados dentro do escopo.
totalEstabelecimentos	Estoque total de estabelecimentos.
estabelecimentosAtivos	Estabelecimentos ativos.
novasMatrizesAtivasNoMes	Novas matrizes ativas no mês.
porUf	Totais distribuídos por UF.
novasDoMesDetalhe	Detalhe opcional das novas empresas por porte.
escopoPortes	Portes usados no cálculo do detalhe.
versaoDosDados	Versão da fotografia/indexação.
staleness	Diagnóstico do mês disponível.
observedAt	Timestamp da execução.

---

CNAE inexistente

O Actor separa:

CNAE não existe na classificação observada

de:

CNAE existe, mas o recorte de UF tem zero estabelecimentos

Se nenhum código compatível existe em célula alguma do Brasil:

CNAE_NOT_FOUND

o pedido é listado no resumo e não é cobrado.

---

Zero legítimo no recorte

Suponha que um CNAE exista no Brasil, mas tenha:

0 estabelecimentos

nas UFs escolhidas.

Esse perfil é uma resposta de mercado legítima:

O mercado existe na classificação, mas não há estabelecimentos nesse recorte.

O CNAE_PROFILE é entregue e cobrado.

---

Detalhe parcial de porte

O perfil principal depende das células agregadas.

O detalhe por porte depende dos chunks das novas matrizes.

Se uma UF do detalhe falhar:

perfil agregado
=
continua íntegro

novasDoMesDetalhe.parcial
=
true

e as UFs indisponíveis são declaradas.

O Actor não transforma uma falha de detalhe em zero silencioso.

---

RUN_SUMMARY

O resumo gratuito pode incluir:

recordsWritten
unitsRequested
unitsOk
unitsFailed
capReason
qualityAlert
sourceUnavailable
warnings
units
outcomeKind
billableRecords
stateVersion
report
httpRequests
cost
pricingLabel

---

report

O bloco gratuito:

report

pode incluir:

indexMonth
staleness
cellsNoIndice
profilesRequested
profilesDelivered
profilesNotFound
profilesSkippedByCap
novasDetalhe

---

STATS

O Key-Value Store padrão recebe:

STATS

com diagnóstico operacional como:

• requests HTTP;
• retries;
• perfis entregues;
• cobrança;
• runtime;
• qualidade;
• staleness;
• warnings;
• custo computacional.

---

Como usar para comparação de mercado

Exemplo:

{
  "cnaes": [
    "56",
    "62",
    "86"
  ],
  "ufs": [
    "SP"
  ],
  "detalharNovas": true
}

Isso produz um perfil para cada pedido.

Você pode comparar:

• tamanho do estoque;
• ativos;
• novas matrizes do mês;
• distribuição de porte das entrantes.

---

Como usar para comparação regional

Exemplo:

{
  "cnaes": [
    "6201501"
  ],
  "ufs": [
    "SP",
    "MG",
    "PR",
    "SC"
  ]
}

O perfil traz:

porUf

para comparar a distribuição regional dentro do mesmo registro.

---

Série histórica mensal

O Actor é stateless.

Para construir uma série histórica:

1. salve a configuração como uma Task;
2. execute uma vez por mês;
3. preserve o Dataset;
4. compare os CNAE_PROFILE ao longo do tempo.

O Actor não mantém automaticamente um histórico agregado entre execuções.

---

API da Apify

Execute via API:

curl -s "https://api.apify.com/v2/acts/<SEU_USUARIO>~cnae-market-intelligence/run-sync-get-dataset-items?token=<SEU_TOKEN>" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "cnaes":["56","6201501"],
    "ufs":["SP"],
    "detalharNovas":true,
    "maxResults":20
  }'

Substitua:

<SEU_USUARIO>
<SEU_TOKEN>

pelos seus dados da Apify.

---

Integrações

Use com:

• Apify API;
• Tasks;
• Schedules;
• webhooks;
• n8n;
• Make;
• Google Sheets;
• bancos de dados;
• BI;
• dashboards;
• CRM;
• aplicações internas.

---

Agendamento

A cadência natural é:

mensal

depois da disponibilidade de uma nova fotografia no índice.

A execução mensal permite criar uma série como:

tamanho
ativos
novos entrantes
distribuição geográfica
porte das novas empresas

---

Cobrança

Este Actor usa:

Pay Per Event

O modelo de publicação contém:

apify-actor-start
cnae-profile

apify-actor-start

É o evento sintético de início da Apify.

Ele é configurado na aba Pricing e cobrado automaticamente pela plataforma.

O código não faz uma segunda cobrança customizada de início.

cnae-profile

É cobrado por CNAE_PROFILE entregue.

Um perfil pode representar:

um CNAE específico

ou:

um prefixo inteiro

A aba Pricing é sempre a fonte autoritativa do preço vigente.

---

O que é gratuito

Não gera cobrança de cnae-profile:

• CNAE inexistente na classificação;
• RUN_SUMMARY;
• pedido além de maxResults;
• execução sem perfil entregue.

Um CNAE existente com zero no recorte continua sendo um perfil entregue/cobrado porque o zero é a resposta.

---

Controle de custo

Principais controles:

cnaes
maxResults
detalharNovas
ufs
maxRuntimeMs

Perfil rápido

Use:

• poucos CNAEs;
• UFs específicas;
• detalharNovas: false quando não precisa de porte.

Análise mais completa

Use:

• múltiplos CNAEs;
• Brasil inteiro;
• detalhe das novas empresas.

A parte de porte pode exigir leituras adicionais dos chunks mensais.

---

Health e transparência

O Actor não converte falha do índice em resposta de mercado.

Ele diferencia:

• índice indisponível;
• contrato do índice alterado;
• CNAE inexistente;
• zero legítimo;
• detalhe de porte parcial;
• staleness;
• cap de execução.

Os avisos ficam em:

RUN_SUMMARY
STATS

---

Limites honestos

Frescor mensal

Este não é um produto de tempo real.

O estoque total inclui matriz e filial

totalEstabelecimentos não é o total de empresas-matriz.

O estoque total inclui diferentes situações

Use estabelecimentosAtivos quando quiser o subconjunto ativo.

Porte só existe nas novas empresas detalhadas

O Actor não possui distribuição de porte do estoque total.

Novas empresas são matrizes ativas

A métrica mensal não inclui filiais novas.

O filtro de porte não muda o perfil agregado

Ele apenas calcula a contagem das novas entrantes dentro dos portes selecionados.

Prefixos podem cobrir muitos CNAEs

Um prefixo como:

47

representa um agrupamento amplo.

cnaesNaClassificacao é do escopo selecionado

O valor conta os códigos CNAE distintos encontrados dentro das UFs do perfil, não necessariamente todos os códigos existentes nacionalmente fora desse escopo.

Não entrega lista de empresas

Use o Actor de empresas novas quando precisar dos leads individualmente.

Reexecução repete o perfil

O Actor é stateless entre runs.

O índice é uma dependência de dados JM Forge

Se o índice mensal estiver indisponível, o Actor não consegue reconstruir o snapshot bruto dentro da mesma execução.

O índice pode ficar atrasado

O output marca:

stale: true

quando o mês disponível está atrás do esperado.

Mês antigo depende de retenção

Um mês explícito funciona somente enquanto as chaves daquele índice mensal estiverem disponíveis.

Nenhum dado de contato

O perfil não inclui telefone, e-mail, site ou sócios.

---

Perguntas frequentes

De onde vêm os dados?

Dos dados abertos oficiais do CNPJ da Receita Federal, transformados em um índice mensal mantido pela JM Forge.

É scraping do site da Receita?

Não.

Preciso de chave da Receita Federal?

Não.

Posso informar um CNAE completo?

Sim.

Posso informar só a divisão CNAE?

Sim.

Exemplo:

{
  "cnaes": [
    "56"
  ]
}

Quantos CNAEs posso pedir?

Até:

200

por execução.

Posso escolher estados?

Sim.

Lista de UFs vazia significa o quê?

Brasil inteiro.

O que é totalEstabelecimentos?

Estoque total de estabelecimentos nas células agregadas do recorte.

Inclui filiais?

Sim.

O que é estabelecimentosAtivos?

O subconjunto em situação ativa.

O que significa novasMatrizesAtivasNoMes?

Matrizes ativas com início de atividade no mês de referência.

O Actor mostra porte?

Das novas empresas, quando o detalhe está ativado.

Não do estoque total.

Posso filtrar o estoque total por porte?

Não nesta versão.

O que acontece se o CNAE não existir?

Não é entregue/cobrado como perfil; fica indicado no resumo.

E se existir, mas tiver zero em SP?

O perfil é entregue com zero e é cobrado.

Posso pedir um mês anterior?

Sim, quando o índice daquele mês ainda estiver disponível.

Como sei se os dados estão atrasados?

Leia:

staleness

O resumo é cobrado?

Não.

Posso agendar?

Sim.

Mensal é a cadência natural.

Pelo que eu pago?

Pelo evento cnae-profile para cada perfil entregue, além do evento sintético de início configurado na Apify.

Este Actor é oficial da Receita Federal?

Não.

É uma ferramenta comunitária independente construída sobre dados públicos oficiais.

---

Suporte

Para bugs, dúvidas ou solicitação de campos:

johnatan291303@gmail.com

Use também a aba Issues na página do Actor.

---

Parte da suíte JM Forge

Também do mesmo desenvolvedor:

• Empresas Novas por CNPJ, CNAE, UF e Porte — leads individuais de novas matrizes ativas do mês.
• Consulta CNPJ Brasil e Empresas por CNAE — consulta cadastral e descoberta de empresas.
• Monitor de Mudanças Cadastrais de CNPJ — mudanças em dados de CNPJ.
• Validador de CNPJ Alfanumérico — Lote e Migração — validação estrutural em lote.
• Triagem CNPJ — CEIS, CNEP, CEPIM e Leniência — triagem factual de sanções federais.

Os Actors permanecem ferramentas independentes.

Use este Actor para inteligência agregada de mercado.

Use os outros produtos quando precisar das empresas ou eventos individuais.