cnpjaberto

Python SDK и сервер Model Context Protocol (MCP) для cnpjaberto.com.br, открытого реестра бразильских компаний (CNPJ). Позволяет выполнять поиск компаний, строить графы партнеров, объединять данные по адресу и контактам, получать статистику по CNAE, а также национальные и годовые обзоры.

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

Быстрый старт с 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")

Анонимные вызовы работают с учетом публичных ограничений по частоте запросов (rate limit). Для использования дневной квоты плана Pro создайте ключ на cnpjaberto.com.br/planos и экспортируйте его:

export CNPJABERTO_API_KEY=sua_chave_aqui

Related MCP server: mcp-server-brasil

MCP-сервер (Claude Desktop, Cursor, Cline)

Установите дополнение и добавьте эту конфигурацию в ваш клиент.

pip install cnpjaberto[mcp]

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

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

Перезапустите Claude Desktop. Теперь можно задавать вопросы, например:

• "Найди CNPJ 18.236.120/0001-58 и скажи, когда компания была основана."

• "Сколько бразильских компаний открылось в 2024 году по сравнению с 2023? В каких штатах наблюдался наибольший рост?"

• "Найди компании, где 'Maria Silva' указана как партнер, с группировкой по штатам."

• "Какие еще компании зарегистрированы по тому же адресу, что и головной офис Magazine Luiza?"

Доступные инструменты

Типизированные ошибки

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

Источник данных

Все данные поступают из публичного дампа CNPJ Федеральной налоговой службы Бразилии, который обновляется ежемесячно. Cnpjaberto.com.br обрабатывает, индексирует и предоставляет их с субсекундным временем отклика, а также добавляет данные с добавленной стоимостью (графы партнеров, общие адреса, агрегаты по CNAE) для примерно 70 миллионов филиалов и 67 миллионов компаний.

Лицензия

MIT.