n8n

n8n 은 개발자들이 가장 먼저 손에 쥐는 오픈 소스 자동화 러너입니다. 내장된 두 노드면 충분합니다 —— HTTP Request 로 작업을 제출하고, Webhook 으로 콜백을 받으세요.

단일 URL —— /distill

1. HTTP Request 노드 추가
2. Method: POST · URL: https://openapi.thunderbit.com/openapi/v1/distill
3. Authentication: Header Auth → Authorization: Bearer YOUR_API_KEY
4. Body (JSON):

{
  "url": "{{ $json.url }}",
  "renderMode": "basic"
}

5. 다음 노드는 {{ $json.data.markdown }} 을 받습니다. Notion, Slack, OpenAI 등으로 흘려보내세요.

배치 —— /batch/distill + Webhook 콜백

URL 5 ~ 10 개 이상이라면 비동기 작업이 정답입니다. 워크플로 두 개로 구성합니다.

Workflow A: 제출자

• HTTP Request → POST /openapi/v1/batch/distill
• Body:

{
  "urls": {{ $json.urls }},
  "callback": {
    "url":    "https://your-n8n.example.com/webhook/thunderbit",
    "secret": "whsec_..."
  }
}

Workflow B: 수신자

• Webhook 노드, path 는 thunderbit
• X-Thunderbit-Signature Header 를 시크릿과 대조 검증(Function 노드, HMAC-SHA256)
• {{ $json.results }} 를 순회하면서 각 markdown 을 싱크에 기록

팁

• 공개 webhook 을 노출할 수 없으면 n8n 의 Wait 노드 + 폴링 HTTP Request 로 /batch/{jobId} 를 조회하세요
• 4xx 한 번에 워크플로 전체가 죽지 않도록 HTTP Request 노드의 Continue On Fail 을 켜세요

관련 문서

• Webhook 가이드
• Batch Job Lifecycle
• Zapier · Make.com