n8n

n8n は、開発者がまず手に取るオープンソースの自動化ランナーです。組み込みノード 2 つで十分 —— 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 コールバック

5-10 URL を超えたら非同期ジョブが正しいパターン。2 つのワークフロー：

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} を叩く
• HTTP Request ノードの Continue On Fail をオンにして、単発の 4xx でワークフローが死なないように

関連

• Webhooks ガイド
• Batch Job Lifecycle
• Zapier · Make.com