busca_avancada
Lista empresas por UF (obrigatória) e CNAE principal (7 dígitos) OU cidade: só UF + cidade, sem CNAE, também funciona (sem ordem explícita a lista sai por atividade, até 50 páginas; com ordem (capital, abertura, nome) a cidade é ordenada estritamente se tiver até 10.000 empresas, senão a ordem é ignorada com aviso e pede cnae; só UF sem cidade nem CNAE é recusado). situacao: ativa (padrão), inapta, baixada, suspensa, nula (estas exigem UF + cidade; lista só cnpj, razão social, situação, data, motivo, matriz e url, sem MEI/EI nem contato; os demais filtros são ignorados e o campo aviso informa) ou todas (ativas + contagens por situação da cidade). Opcionais: cidade, porte (ME, EPP, Demais), faixa de capital social e listada (só companhias da B3; aí o CNAE é opcional) opcionais. Cada resultado traz b3 {tickers} quando a empresa é listada. Filtros de site (pós-filtro sobre amostra de candidatas, total aproximado; MEI/EI sempre excluídos): tem_site, e_commerce (só lojas virtuais) e plataforma (vtex, shopify, nuvemshop, tray, lojaintegrada, woocommerce…; implica e_commerce); cada resultado com site traz plataforma e e_commerce. Devolve total e 20 por página. A Receita não publica faturamento: faixa_receita_estimada vem do porte (ME até R$ 360 mil/ano, EPP até R$ 4,8 mi). Limites grátis normais.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"uf": "<uf>"
},
"name": "busca_avancada"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uf | Yes | ||
| cvm | No | todas = qualquer companhia com registro na CVM (ativo ou cancelado); ativa = só registro ativo. Cada resultado traz cvm {situacao_registro}. Aí cnae é opcional | |
| cnae | No | CNAE principal, 7 dígitos (opcional se informar UF + cidade) | |
| ordem | No | padrão capital_desc; só UF + cidade sem cnae: vale em cidades de até 10.000 empresas, nas maiores sai por atividade com aviso | |
| porte | No | ME, EPP ou Demais (vírgula para vários) | |
| cidade | No | Nome do município; com UF dispensa o cnae | |
| pagina | No | ||
| regime | No | Regime: simples (sem MEI), mei, outros (fora do Simples) | |
| listada | No | true = só companhias abertas listadas: negociou na B3 em 52 semanas ou tem registro ATIVO na CVM (aí cnae é opcional) | |
| situacao | No | padrão ativa; inapta/baixada/suspensa/nula exigem UF + cidade e ignoram os demais filtros (aviso no resultado); todas = ativas + contagens por situação | |
| tem_site | No | ||
| e_commerce | No | Só empresas com loja virtual (carrinho de e-commerce detectado no site; pós-filtro sobre amostra de candidatas, total aproximado; MEI/EI sempre excluídos) | |
| plataforma | No | Plataforma de e-commerce do site (implica e_commerce): vtex, shopify, nuvemshop, tray, lojaintegrada, woocommerce, magento, wix, stores, bagy, yampi, vnda, jet, wake, opencart, prestashop, salesforce, linx, irroba, xtech, mercadoshops, bigcommerce, squarespace | |
| por_pagina | No | ||
| abertura_de | No | Aberta a partir de (AAAA, AAAA-MM ou AAAA-MM-DD) | |
| capital_max | No | ||
| capital_min | No | ||
| abertura_ate | No | Aberta até (AAAA, AAAA-MM ou AAAA-MM-DD) | |
| tem_telefone | No |