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

公開されているツール

ツール

戻り値

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。

A
license - permissive license
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • CNPJ Brazil MCP — Brazilian company-registry (Receita Federal) lookup via

  • MCP server for live, sourced Brazilian public data from the official IBGE APIs.

  • MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cnpjaberto/cnpjaberto-py'

If you have feedback or need assistance with the MCP directory API, please join our Discord server