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 similaresfrom 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_aquiRelated MCP server: brdata-mcp
추가 기능을 설치하고 클라이언트에 다음 설정을 추가하십시오.
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 본사와 같은 주소에 등록된 다른 기업들은 어디야?"
도구 | 반환 내용 |
| 전체 등록 정보: 회사명, 자본금, 파트너, |
| 본사의 지사 목록, 페이지네이션 지원, UF별 필터링 가능 |
| 회사명, 상호명 또는 CNPJ 숫자로 검색 (최소 3자) |
| 특정 인물이 파트너로 등록된 기업; |
| 같은 주소에 등록된 다른 기업들 |
| 같은 이메일이나 전화번호를 공유하는 기업들 |
| 특정 CNAE의 집계 통계 (개수, 상위 UF, 상위 시/군) |
| 국가 통계: 상위 UF 및 CNAE, 자본금 범위, 연령, 10년 이력 |
| 연간 분석: 개업 및 폐업, 월별 시계열, 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천만 개의 사업장과 6천 7백만 개의 기업에 대해 데이터를 수집, 인덱싱하고 1초 미만의 조회 속도와 부가가치 조인(파트너 그래프, 공유 주소, CNAE별 집계)을 제공합니다.
MIT.
This server cannot be deployed
Official remote MCP server for Brazilian company data (CNPJ): lookup, filtered search, contacts and partners with masked CPF. 70M CNPJs, base of Aug 2026; updated monthly, with the base date in every response. https://cnpj.ia.br/?utm_source=glama&utm_medium=listing
CNPJ Brazil MCP — Brazilian company-registry (Receita Federal) lookup via
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Brazilian company and person data by CNPJ/CPF: registry, partners, tax status, sanctions, lawsuits.
