Para agentes de IA (navegador, sem MCP)
Agentes que usam navegador ou tela (computer-use) podem usar o Fichário como uma pessoa usaria, sem instalar MCP nem chave de API. Todas as páginas abaixo vêm com o resultado pronto no HTML, então funcionam mesmo sem JavaScript, e cada campo tem um rótulo visível.
1. Monte a URL direto (o jeito mais confiável)
| O que você quer | URL |
|---|---|
| Empresas por atividade, estado e cidade | https://cnpj.genesisinnovation.io/busca-avancada?cnae=4781400&uf=SC&cidade=Blumenau |
| Filtrar porte (ME, EPP, Demais) e capital social | …&porte=ME&capital_min=0&capital_max=100000 |
| Só companhias listadas na B3 | https://cnpj.genesisinnovation.io/busca-avancada?uf=SP&listada=1 (o CNAE fica opcional) |
| Próxima página | …&pagina=2 (20 por página, até 50 páginas) |
| Ficha de uma empresa | https://cnpj.genesisinnovation.io/cnpj/05844751000108 (14 dígitos, sem pontuação) |
| Busca por nome ou CNPJ | https://cnpj.genesisinnovation.io/busca?q=paraiso+da+moda |
| Planilha (CSV) | https://cnpj.genesisinnovation.io/api/v1/busca-avancada?cnae=4781400&uf=SC&formato=csv |
cnae é a atividade principal, com 7 dígitos (sem pontos nem barra). uf é a sigla do estado. cidade é o nome sem acento ou com acento (tanto faz).
2. Ou preencha o formulário pelos rótulos
Em /busca-avancada, os campos têm os rótulos: Atividade (CNAE principal), Estado (UF), Cidade, Porte, Capital social e a caixa Só listadas na B3. Depois clique no botão Buscar. Nos resultados aparecem os links Próxima página →, ← Página anterior e Exportar CSV, e o botão Copiar link. O nome de cada empresa é um link para a ficha.
3. Onde ler o resultado
- Total:
#ba-total(atributodata-total; acima de 10.000 aparece "10.000+"). - Tabela:
#ba-resultados. Cada linha temdata-cnpj,data-portee, se for listada na B3,data-b3com os tickers. - Ids estáveis do formulário:
#ba-form,#ba-cnae,#ba-uf,#ba-cid,#ba-porte,#ba-faixa,#ba-listada,#ba-buscar. Paginação:#ba-proximae#ba-anterior. CSV:#ba-csv. - Erros aparecem num aviso com
role="alert"e texto em português (por exemplo, "Escolha o estado (UF).").
4. Limites e fonte
- Grátis, sem login: 60 páginas ou chamadas por minuto e 3.000 por dia por IP. Acima disso o site responde HTTP 429 com as opções de upgrade.
- CSV: 100 linhas grátis e 5.000 no plano Pro.
- Fonte: dados abertos do CNPJ da Receita Federal, base de outubro de 2026. Só empresas ativas. A Receita não publica faturamento; a faixa de receita vem do porte (ME até R$ 360 mil/ano, EPP até R$ 4,8 milhões/ano).
- Prefere API ou MCP? Veja /api, /openapi.json e /llms.txt.
Exemplo de roteiro para um agente
1. Abra https://cnpj.genesisinnovation.io/busca-avancada?cnae=4781400&uf=SC&cidade=Blumenau&porte=ME 2. Leia o total em #ba-total e as linhas de #ba-resultados 3. Clique em "Próxima página →" para continuar 4. Clique no nome de uma empresa para abrir a ficha (/cnpj/…) 5. Clique em "Exportar CSV" para baixar a planilha