n8n
코드 없이 워크플로에서 쓰는 회사 데이터.
n8n 노드를 쓰면 코드 없이 워크플로로 회사 데이터를 가져와요. 이 노드는 n8n의 인증을 받았고, 자체 소프트웨어와 같은 API를 호출해요.
노드 설치
인증된 노드는 에디터에서 바로 설치해요. n8n 인스턴스의 소유자나 관리자만 설치할 수 있고, 설치 후에는 모든 멤버가 노드를 쓸 수 있어요.
- 워크플로를 열고 “+”를 눌러 노드 패널을 여세요.
- “handelsregister.ai”를 검색하고 인증 배지가 있는 노드를 고르세요.
- “Install”을 누르세요.
- “Handelsregister.ai API” 자격 증명을 만들고 API 키를 입력하세요. 또는 Bearer 토큰을 쓰세요.
자체 호스팅 인스턴스에서는 Settings › Community Nodes에서 패키지 이름 @handelsregister/n8n-nodes-handelsregister-ai로 노드를 설치할 수도 있어요.
인증된 노드가 인스턴스에 표시되는지는 설정에 따라 달라요. n8n Cloud에서는 소유자가 Cloud 관리 패널에서 정해요.
작업
노드는 API 엔드포인트를 작업(operation)으로 제공해요. 크레딧은 API와 같아요.
| 작업 | 하는 일 | 크레딧 |
|---|---|---|
| Fetch Organization | 기능, AI 모드, 실시간 모드를 고를 수 있는 회사 프로필. | 5 + 기능 |
| Search Organizations | 이름과 필터로 회사 검색. “Return All”은 모든 결과 페이지를 넘기고, “Maximum Results”는 개수를 제한해요. | 페이지당 1 |
| Fetch Person | 인물 프로필, Plus부터. | 15 |
| Fetch Document | 등기부 문서. 파일은 바이너리 속성 “data”에 담겨요. | 15 |
| List Signals | 주제, 회사, 기간별 Signals, 페이지 단위. | 페이지당 20 |
| Get Signal | 개별 Signal. | 20 |
| Get Signal Catalog | Signals 주제. | 무료 |
읽기 요청에서 노드는 네트워크 오류, 408, 429, 서버 오류를 최대 세 번 재시도해요. “Continue On Fail”을 켜면 워크플로가 계속 실행되고, 결과에 상태, 오류 코드, meta가 담겨요.
예시 워크플로
이 워크플로는 한 우편번호 지역의 모든 활성 GmbH 목록을 경영진과 함께 만들어요.
- 트리거로 시작하세요. 예: 시험용 “Manual Trigger” 또는 정해진 일정용 “Schedule Trigger”.
- “Search Organizations” 작업으로 handelsregister.ai 노드를 추가하세요. 필터에서 우편번호, 법적 형태 GmbH, 상태 active를 설정하세요.
- “Output”을 회사당 항목 하나로 설정하세요. “Return All”을 켜고 “Maximum Results”로 개수를 제한하세요. 그러면 이어질 회사 프로필 수를 미리 알 수 있어요.
- “Fetch Organization”으로 두 번째 handelsregister.ai 노드를 추가하세요.
q에 표현식{{ $json.entity_id }}를 넣고 Related Persons 기능(경영진)을 고르세요. - 결과를 원하는 곳에 쓰세요. 예: 스프레드시트나 CRM.
검색은 페이지당 1 크레딧예요. 회사 프로필은 각각 5 크레딧이고, 경영진이 데이터를 반환하면 2 크레딧가 더해져요.