Buscar empresas
buscar_empresasSearch and list Brazilian companies by CNAE, location, status, size, and capital filters to retrieve CNPJ, address, activity, and contact details with exact total counts.
Instructions
Lista empresas (estabelecimentos) que atendem aos filtros, com CNPJ, razão social, atividade, endereço e contatos cadastrados na Receita. O campo total é a contagem exata de todas as empresas que atendem aos filtros, sem amostragem nem teto; limite e deslocamento só controlam quais delas vêm na lista.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "buscar_empresas"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mei | No | Como tratar Microempreendedores Individuais (MEI). | incluir |
| ufs | No | Siglas das UFs, ex.: ["SP", "MG"]. | |
| ceps | No | Prefixos de CEP, apenas dígitos, ex.: ["13010", "130"]. | |
| cnaes | No | Códigos CNAE. Com 7 dígitos busca a subclasse exata; com menos dígitos busca por prefixo (ex.: "4520" = toda a classe). Use buscar_cnae para descobrir os códigos. | |
| limite | No | Máximo de empresas retornadas. | |
| portes | No | Porte declarado à Receita. | |
| bairros | No | Trechos do nome do bairro (busca parcial). | |
| situacao | No | Situação cadastral. Padrão: ativa. | ativa |
| com_email | No | Somente empresas com e-mail cadastrado. | |
| municipios | No | Nomes dos municípios, sem diferenciar maiúsculas e acentos. Combine com ufs para evitar homônimos. | |
| aberta_apos | No | Data de abertura a partir de (AAAA-MM-DD). | |
| capital_max | No | Capital social máximo em reais. | |
| capital_min | No | Capital social mínimo em reais. | |
| ordenar_por | No | mais_recentes | |
| aberta_antes | No | Data de abertura até (AAAA-MM-DD). | |
| com_telefone | No | Somente empresas com telefone cadastrado. | |
| deslocamento | No | Quantas empresas pular (paginação). | |
| somente_matriz | No | Ignorar filiais. | |
| ocultar_contatos_mei | No | Ocultar telefone e e-mail de MEIs, que costumam ser os da própria pessoa física. Use ao compartilhar os resultados. | |
| incluir_cnae_secundario | No | Também considerar empresas que têm o CNAE como atividade secundária. |