Skip to main content
Glama
cnpjaberto

cnpjaberto

Official
by cnpjaberto

cnpjaberto

用于 cnpjaberto.com.br 的 Python SDK 和 Model Context Protocol (MCP) 服务器,这是巴西企业 (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")

匿名调用可以使用,但受公共速率限制。如需 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 总部所在的同一地址?”

公开的工具

工具

返回内容

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

数据来源

所有数据均来自巴西联邦税务局的公共 CNPJ 转储,每月更新。cnpjaberto.com.br 对约 7000 万个机构和 6700 万家公司的数据进行摄取、索引,并提供亚秒级查询,以及增值关联(合伙人关系图、共享地址、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