cnpjaberto

Python-SDK und Model Context Protocol (MCP)-Server für cnpjaberto.com.br, das offene Register brasilianischer Unternehmen (CNPJ). Ermöglicht Unternehmensabfragen, Gesellschafter-Graphen, Joins nach Adresse und Kontakt, Statistiken nach CNAE sowie nationale und jährliche Panoramen.

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

Schnelleinstieg mit dem 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")

Anonyme Aufrufe funktionieren, unterliegen jedoch dem öffentlichen Rate-Limit. Für das tägliche Kontingent des Pro-Plans generieren Sie einen Schlüssel unter cnpjaberto.com.br/planos und exportieren Sie diesen:

export CNPJABERTO_API_KEY=sua_chave_aqui

Related MCP server: mcp-server-brasil

MCP-Server (Claude Desktop, Cursor, Cline)

Installieren Sie das Extra und fügen Sie diese Konfiguration in Ihrem Client hinzu.

pip install cnpjaberto[mcp]

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

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

Starten Sie Claude Desktop neu. Jetzt können Sie Fragen stellen wie:

• "Frage die CNPJ 18.236.120/0001-58 ab und sag mir, wann sie gegründet wurde."

• "Wie viele brasilianische Unternehmen wurden 2024 im Vergleich zu 2023 eröffnet? Welche Bundesstaaten sind am stärksten gewachsen?"

• "Finde Unternehmen, bei denen 'Maria Silva' als Gesellschafterin auftritt, gruppiert nach Bundesstaat."

• "Welche anderen Unternehmen sind an derselben Adresse wie der Hauptsitz von Magazine Luiza registriert?"

Verfügbare Tools

Typisierte Fehler

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:
        ...

Datenquelle

Alle Daten stammen aus dem öffentlichen CNPJ-Dump der brasilianischen Bundessteuerbehörde (Receita Federal), der monatlich aktualisiert wird. cnpjaberto.com.br erfasst, indiziert und stellt diese mit Sub-Sekunden-Lookups bereit, ergänzt durch Mehrwert-Joins (Gesellschafter-Graph, geteilte Adressen, CNAE-Aggregate) für etwa 70 Millionen Betriebsstätten und 67 Millionen Unternehmen.

Lizenz

MIT.