cnpj

Modulo CNPJ: consulta e validação de empresas na Receita Federal.

CNPJResponse

Bases: BaseResponse

Resposta completa de consulta de CNPJ.

QSASocio

Bases: BaseModel

Socio do Quadro Societario e Administrativo (QSA).

consultar_cnpj async

consultar_cnpj(cnpj)

Consulta os dados cadastrais de uma empresa pelo CNPJ.

Aceita o CNPJ com ou sem formatação (pontos, barra, traço). Retorna razão social, endereço, atividades econômicas, sócios e situação cadastral.

Parameters:

Name	Type	Description	Default
cnpj	str	Número do CNPJ (ex: '11.222.333/0001-81' ou '11222333000181')	required

Returns:

Type	Description
CNPJResponse	CNPJResponse com os dados completos da empresa.

Raises:

Type	Description
ValidationError	Se o CNPJ for inválido.
NotFoundError	Se o CNPJ não for encontrado na Receita Federal.
APIError	Em caso de falha nas APIs consultadas.

listar_cnpjs_por_nome async

listar_cnpjs_por_nome(nome, uf=None)

Busca empresas pelo nome ou razão social.

Retorna uma lista simplificada com CNPJ e razão social. Nota: esta funcionalidade depende de APIs de terceiros com disponibilidade variável.

Parameters:

Name	Type	Description	Default
nome	str	Nome ou parte da razão social da empresa.	required
uf	str | None	Sigla do estado para filtrar (ex: 'SP', 'MG'). Opcional.	None

Returns:

Type	Description
list[dict[str, str]]	Lista de dicionários com 'cnpj' e 'razao_social'.

client

Cliente para consulta de CNPJ via BrasilAPI e ReceitaWS.

CNPJClient

Cliente para busca de dados de CNPJ em fontes publicas.

consultar async

consultar(cnpj)

Consulta os dados de um CNPJ.

Tenta BrasilAPI primeiro; em caso de falha, tenta ReceitaWS.

schemas

Schemas Pydantic para dados de CNPJ.

QSASocio

Bases: BaseModel

Socio do Quadro Societario e Administrativo (QSA).

AtividadeCNAE

Bases: BaseModel

Atividade economica conforme CNAE.

CNPJResponse

Bases: BaseResponse

Resposta completa de consulta de CNPJ.

tools

Ferramentas MCP para consulta de CNPJ.

consultar_cnpj async

consultar_cnpj(cnpj)

Consulta os dados cadastrais de uma empresa pelo CNPJ.

Aceita o CNPJ com ou sem formatação (pontos, barra, traço). Retorna razão social, endereço, atividades econômicas, sócios e situação cadastral.

Parameters:

Name	Type	Description	Default
cnpj	str	Número do CNPJ (ex: '11.222.333/0001-81' ou '11222333000181')	required

Returns:

Type	Description
CNPJResponse	CNPJResponse com os dados completos da empresa.

Raises:

Type	Description
ValidationError	Se o CNPJ for inválido.
NotFoundError	Se o CNPJ não for encontrado na Receita Federal.
APIError	Em caso de falha nas APIs consultadas.

listar_cnpjs_por_nome async

listar_cnpjs_por_nome(nome, uf=None)

Busca empresas pelo nome ou razão social.

Retorna uma lista simplificada com CNPJ e razão social. Nota: esta funcionalidade depende de APIs de terceiros com disponibilidade variável.

Parameters:

Name	Type	Description	Default
nome	str	Nome ou parte da razão social da empresa.	required
uf	str | None	Sigla do estado para filtrar (ex: 'SP', 'MG'). Opcional.	None

Returns:

Type	Description
list[dict[str, str]]	Lista de dicionários com 'cnpj' e 'razao_social'.