전체 문서 및 이미지 파이프라인을 위한 하나의 n8n Node
Source: Dev.to
세‑서비스 파이프라인 문제
인보이스를 n8n 워크플로우에서 처리해야 합니다. 일반적으로 다음과 같이 연결합니다:
- Mistral OCR – 텍스트 추출
- GPT‑4o – JSON 형태로 구조화
- Google Sheets – 결과 저장
세 개의 서비스, 세 개의 인증 정보 세트, 그리고 세 개의 청구 계정이 필요합니다. OCR은 페이지당 비용이 발생하고, LLM은 토큰당 비용이 발생하며, 실행될 때마다 두 서비스 모두 크레딧이 소모됩니다.
그 후 누군가 추출된 데이터로 PDF 요약을 생성해 달라고 하면, 네 번째 서비스를 추가하게 됩니다(예: PDF.co, HTML‑to‑PDF 노드, 혹은 Puppeteer를 호출하는 Function 노드). 각 옵션마다 고유한 quirks, 인증 방식, 실패 모드가 존재합니다.
결과적으로 HTTP Request 노드, 포맷 변환을 위한 Function 노드, 그리고 base64 인코딩/디코딩을 연결하는 접착제 형태의 조각조각이 됩니다. 대부분의 n8n 문서 워크플로우가 이렇게 끝나는 이유는 접근 방식이 잘못됐기 때문이 아니라, 단일 도구가 전체 파이프라인을 모두 커버하지 못하기 때문입니다. 추출에는 한 공급업체, 변환에는 또 다른 공급업체, 생성에는 세 번째 공급업체가 필요합니다.
Iteration Layer 커뮤니티 노드
Iteration Layer n8n 커뮤니티 노드는 추출, 변환, 생성 작업을 하나의 설치로 통합합니다.
- 드롭다운에서 리소스를 선택하세요:
- Document Extraction
- Image Transformation
- Image Generation
- Document Generation
- Sheet Generation
- Document to Markdown
- 매개변수를 입력합니다.
- 노드는 인증, 바이너리 데이터 및 응답 파싱을 자동으로 처리합니다.
Practical impact:
이전에는 세 개의 별도 서비스와 다섯 개의 n8n 노드가 필요했던 파이프라인을 두 개의 Iteration Layer 노드만으로 연결할 수 있습니다. 바이너리 데이터가 네이티브하게 흐르므로 Base64를 디코딩하는 Function 노드도, 포맷 변환용 접착제도 필요 없습니다. 하나의 API 키, 하나의 크레딧 풀, 그리고 각 리소스의 출력이 다음 단계로 바로 전달되도록 설계되었습니다.
설치
n8n UI에서
- Settings > Community Nodes를 엽니다.
- Install a community node를 클릭하고
n8n-nodes-iterationlayer를 입력한 뒤 설치합니다.
자체 호스팅 n8n
cd ~/.n8n
npm install n8n-nodes-iterationlayer설치 후 n8n을 재시작합니다. 그 다음:
- Credentials > New Credential로 이동합니다.
- Iteration Layer API를 검색하고 API 키를 입력합니다.
무료 체험 키를 받으세요 (신용카드 없이).
예시 파이프라인
Document Extraction → Document Generation
| Node | Resource | Key Settings |
|---|---|---|
| Node 1 | Document Extraction | • Input: invoice PDF (email trigger, file upload, or URL) • Define extraction schema (invoice number, vendor name, line items, total) |
| Node 2 | Document Generation | • Output format: PDF • Build document definition using extracted data via n8n expressions |
추출 노드는 신뢰도 점수가 포함된 구조화된 JSON을 반환합니다; 생성 노드는 해당 JSON을 사용해 바이너리 PDF 데이터를 출력하며, 이는 이메일 전송, Google Drive 업로드, 또는 S3 쓰기와 같은 후속 작업에 바로 사용할 수 있습니다.
Image Transformation → Image Generation
| Node | Resource | Key Settings |
|---|---|---|
| Node 1 | Image Transformation | • Input: image from trigger or file node • Operations: resize to 1200×1200, smart crop, sharpen, convert to WebP |
| Node 2 | Image Generation | • Canvas: processed image as a layer • Add text layers (product name, price) • Output format: PNG |
첫 번째 노드의 바이너리 출력은 변환 단계 없이 바로 두 번째 노드에 연결됩니다.
기타 일반적인 조합
- Document to Markdown → Document Extraction – 복잡한 PDF를 깔끔한 Markdown으로 변환한 뒤 구조화된 데이터를 추출합니다.
- Document Extraction → Sheet Generation – 여러 청구서에서 데이터를 추출하고 포맷된 Excel 보고서를 생성합니다.
- Image Transformation → Document Generation – 제품 사진을 처리한 뒤 PDF 카탈로그로 편집합니다.
모든 리소스는 이전 노드의 바이너리 데이터나 URL을 입력으로 받을 수 있으며, 파일을 생성하는 리소스는 n8n 바이너리 데이터를 출력합니다. 이러한 출력은 중간 단계 없이 바로 S3, Google Drive, Slack, 이메일 등 하위 노드로 연결됩니다.
왜 Iteration Layer를 사용하나요?
- 단일 통합은 여러 HTTP Request 및 Function 노드를 대체합니다.
- 통합 청구 – 하나의 API 키, 하나의 크레딧 풀.
- 결정론적, 스키마‑기반 추출은 신뢰도 점수, 인용 및 출처 참조와 함께 제공되며, 토큰당 LLM 예측이 없습니다.
- 올‑인‑원 UI – JSON을 작성하지 않고도 최대 24개의 이미지 작업, 문서 템플릿 및 시트 레이아웃을 구성할 수 있습니다.
현재 추출, 변환 또는 생성 작업을 위해 여러 서비스를 연결하고 있다면, Iteration Layer 커뮤니티 노드가 이를 하나의 통합으로 통합하여 보다 빠르게 견고한 문서 및 이미지 파이프라인을 구축할 수 있습니다.