cnpjaberto

SDK en Python y servidor Model Context Protocol (MCP) para cnpjaberto.com.br, el registro abierto de empresas brasileñas (CNPJ). Permite la consulta de empresas, grafos de socios, uniones por dirección y contacto, estadísticas por CNAE y panoramas nacionales y anuales.

pip install cnpjaberto          # apenas SDK
pip install cnpjaberto[mcp]     # SDK + servidor MCP para Claude Desktop e similares

Inicio rápido con el SDK

from cnpjaberto import Client

with Client() as cnpj:                       # lê CNPJABERTO_API_KEY do ambiente
    empresa = cnpj.lookup("18.236.120/0001-58")
    print(empresa["razao_social"])

    achados = cnpj.search("nubank", per_page=5)
    for h in achados["results"]:
        print(h["cnpj"], h["razao_social"])

    snap = cnpj.panorama_year(2024)
    print(f"{snap['abertas']:,} abertas, {snap['fechadas']:,} fechadas em 2024")

Las llamadas anónimas funcionan, sujetas al límite de tasa público. Para la cuota diaria del plan Pro, genere una clave en cnpjaberto.com.br/planos y expórtela:

export CNPJABERTO_API_KEY=sua_chave_aqui

Related MCP server: mcp-server-brasil

Servidor MCP (Claude Desktop, Cursor, Cline)

Instale el extra y añada esta configuración en su cliente.

pip install cnpjaberto[mcp]

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "cnpjaberto": {
      "command": "cnpjaberto-mcp",
      "env": { "CNPJABERTO_API_KEY": "sua_chave_aqui" }
    }
  }
}

Reinicie Claude Desktop. Ahora puede preguntar cosas como:

• "Consulta el CNPJ 18.236.120/0001-58 y dime cuándo fue fundado."

• "¿Cuántas empresas brasileñas se abrieron en 2024 frente a 2023? ¿Qué estados crecieron más?"

• "Busca empresas donde 'Maria Silva' aparezca como socia, agrupando por estado."

• "¿Qué otras empresas están registradas en la misma dirección que la sede de Magazine Luiza?"

Herramientas expuestas

Errores tipados

from cnpjaberto import Client, NotFoundError, RateLimitError, AuthError

with Client() as cnpj:
    try:
        cnpj.lookup("00000000000000")
    except NotFoundError:
        ...
    except RateLimitError as e:
        print("Cota diária:", e.payload)
    except AuthError:
        ...

Fuente de datos

Todos los datos provienen del volcado público de CNPJ de la Receita Federal, actualizado mensualmente. Cnpjaberto.com.br ingiere, indexa y sirve con búsquedas sub-segundo, además de uniones de valor agregado (grafo de socios, direcciones compartidas, agregados por CNAE) sobre cerca de 70 millones de establecimientos y 67 millones de empresas.

Licencia

MIT.