개요
독일의 공식 회사 데이터: API로, 채팅에서, 또는 코드 한 줄 없이.
handelsregister.ai는 독일 회사의 공식 데이터를 기계가 읽을 수 있게 만들어요. 등기부에서는 회사를 하나씩, 대부분 PDF로 봐요. 여기서는 이름, 등기 번호 또는 entity_id로 회사를 조회하고 프로필을 JSON으로 받아요. 요청하면 대표이사, 주주, 재무도 함께 받을 수 있어요. 그 밖에 인물, 회사 목록, 문서, 등기부의 새 등기도 있어요.
제공되는 것
모든 상품은 하나의 API와 하나의 API 키로 이용해요. 모든 비용은 크레딧으로 과금돼요.
| 상품 | 제공 내용 | 엔드포인트 |
|---|---|---|
| 회사 프로필 | 등기된 모든 회사의 기본 데이터에 더해, 필요에 따라 대표이사, 주주, 재무, 공고. 예: 대표이사와 재무 KPI를 포함한 Hetzner Online GmbH, Ansbach HRB 6089 요청. | fetch-organization |
| 인물 프로필 | 한 인물의 직위와 지분, 웹 조사로 보강. 예: 여러 회사에서 역할을 맡은 Max Mustermann(샘플 데이터). | fetch-person |
| 검색 및 내보내기 | 이름이나 도시, 법적 형태, 업종, 상태 같은 필터로 회사를 찾아요. 예: Gunzenhausen의 모든 활성 GmbH. | search-organizations |
| 문서 | 공식 문서를 파일로: 등기부 등본, Gesellschafterliste(주주 명부), 정관, XML로 된 구조화 등기 내용. 예: 예시 요청에 나온 Hetzner Online GmbH의 주주 명부 PDF. | fetch-document |
| Signals | 모든 회사에 걸친 등기부의 새 등기를 신규 등기, 경영진 변경, 자본금 변경 같은 주제별로. 예: 지난주의 모든 자본금 변경. | signals |
| Monitoring | 회사를 고르면 정한 간격으로 저희가 확인해요. 새 등기는 웹훅으로 전달돼요. 예: 고객사의 경영진 변경. | account/monitors |
데이터에 이르는 세 가지 방법
세 가지 방법 모두 같은 데이터에 접근하고 같은 크레딧 잔액에서 차감돼요.
- API. 자체 소프트웨어용. API 키와 함께 HTTP 요청을 보내면 JSON을 받아요. Python과 Node.js용 SDK, n8n용 노드가 준비되어 있어요. 빠른 시작에서 바로 시작하세요.
- ChatGPT 플러그인과 MCP 서버. AI 에이전트용. 질문하면 에이전트가 직접 데이터를 가져와요. ChatGPT에서는 플러그인을 추가하고 계정으로 로그인해요. Claude, Cursor 및 기타 MCP 클라이언트는 서버 URL로 연결해요. 자세한 내용은 ChatGPT 플러그인과 MCP에 있어요.
- Playground. 코드 한 줄 없이 브라우저에서 시험해 보는 곳. 모든 설정에 해당 API 파라미터가 표시되고, JSON 보기에는 API의 실제 응답이 나와요. 요청에 맞는 코드를 한 번의 클릭으로 복사해요. Playground로 이동하세요.
데이터의 출처
데이터는 주로 공식 출처에서 와요. Handelsregister(상업 등기부)와 등기 포털의 다른 등기부가 기본 데이터, 인물, 공고, 문서를 제공해요. 연간 재무제표는 Unternehmensregister(기업 등기부)와 Bundesanzeiger(연방 관보)에서, 파산 공고는 파산 법원에서 와요. 연락처, 키워드, 뉴스, 웹사이트 내용은 웹에서 가져와요.
이 모든 것을 하나의 회사 프로필로 묶고, 고유 ID로 회사와 인물을 연결해요. 어떤 회사에 무엇이 있는지는 데이터 제공 범위에서 설명해요.