Skip to main content
Glama
cnpjaberto

cnpjaberto

Official
by cnpjaberto

cnpjaberto

ブラジルの企業登録(CNPJ)のオープンデータベースである cnpjaberto.com.br 用のPython SDKおよび Model Context Protocol (MCP) サーバーです。企業照会、パートナーグラフ、住所や連絡先による結合、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")

匿名呼び出しは可能ですが、パブリックレート制限の対象となります。Proプランの1日あたりの割り当てを利用するには、cnpjaberto.com.br/planos でキーを生成し、以下のようにエクスポートしてください。

export CNPJABERTO_API_KEY=sua_chave_aqui

Related MCP server: brdata-mcp

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の本社と同じ住所に登録されている他の企業は?"

公開されているツール

ツール

戻り値

lookup_cnpj(cnpj)

完全な登録情報:商号、資本金、パートナー、estabelecimentos[](本社および支店、住所、電話番号、CNAE)

list_filiais(cnpj)

本社の支店一覧(ページネーション対応、UFによるフィルタリング可)

search_companies(query)

商号、屋号、またはCNPJの数字による検索(最小3文字)

companies_by_owner(name)

特定の人物がパートナーとして登録されている企業(cpfで同姓同名を識別可能)

companies_at_same_address(cep, logradouro, numero)

同じ住所に登録されている他の企業

companies_by_contact(email | ddd+telefone)

同じメールアドレスまたは電話番号を共有している企業

cnae_stats(codigo)

CNAEの集計統計(件数、上位UF、上位自治体)

panorama_overview()

国別の統計:上位UFとCNAE、資本金範囲、設立年数、過去10年の履歴

panorama_year(year)

年次データ:設立数と閉鎖数、月次推移、MEI(個人零細企業)の割合

型付きエラー

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

データソース

すべてのデータは、連邦歳入庁(Receita Federal)の公開CNPJダンプから取得されており、毎月更新されます。cnpjaberto.com.brは、約7,000万の事業所と6,700万の企業に関するデータをインジェストおよびインデックス化し、サブ秒単位のルックアップと付加価値結合(パートナーグラフ、共有住所、CNAE集計など)を提供します。

ライセンス

MIT。

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    An MCP server for querying data on 27 million Brazilian companies from the Federal Revenue, enabling searches by CNPJ, company name, location, and industry. It supports advanced features like partner discovery, sector benchmarking, and similarity analysis.
    16
    17 npm
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    An MCP server for Brazilian company and public procurement data, enabling CNPJ lookup, company search, tender resolution, and more via paid USDC-based API calls.
    15
    44 npm
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    MCP server that provides access to Brazilian public and commercial data, including CNPJ company info, government procurement (PNCP) searches, and FIPE vehicle pricing, with optional alert registration for new tenders.
    -