AI - ドキュメントパーサー n8n

このノードの機能

PDF4me AIドキュメントパーサー 保存済みのスクリプトを実行することで、あらゆるドキュメントから構造化データを抽出します。 AI アナライザ あなたの PDF4me ファイルに対してアカウントを作成します。固定パーサー（AI-Invoice Parser、AI-Process Contract）とは異なり、 AI アナライザーID アナライザーのドロップダウンから PDF4me ダッシュボードなので、同じノードが請求書、発注書、領収書、カスタムフォーム、ラボレポート、内部テンプレートなど、スキーマで記述したあらゆるものを処理します。解析単一スキーマまたは 分類する 1回の呼び出しで複数のドキュメントバリアントを分析するアナライザー。動的な値を返します。 JSON スキーマと _メタデータ ブロック、バイナリファイルなし。

テスト用サンプル請求書

このサンプルベンダー請求書を使用して、ワークフローをライブデータに向ける前に、ノードがエンドツーエンドで動作することを確認します。バイナリ入力としてマッピングし、 default_invoice_extraction として AI アナライザーID。

推奨

ベンダー請求書のサンプル（PDF）

実際のベンダー請求書が組み込まれています デフォルトの請求書抽出 アナライザーは箱から出してすぐに認識します。

sample-vendor-invoice.pdf

認証 API リクエスト

毎 PDF4me ノード n8n 有効な 接続するための認証情報. 作成または選択して、 PDF4me API ワークフローが認証できるようにするためのキー AI 抽出要求を安全に実行します。同じ認証情報で、 AI アナライザーID GetAnalyzerId によるドロップダウン API。

Get your API Key Open AI Document Parser Dashboard

まずアナライザーをセットアップしてください

このガイドで使用するダッシュボードのURL：

アナライザーリスト（ステップ 1–2）： https://dev.pdf4me.com/dashboard/#/ai-document-parser/
分析装置の詳細（ステップ 3–5）： https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid>

まずアナライザーを作成してください（すべてのプラットフォームで必須です）。

AI - ドキュメントパーサーは、PDF4me 開発者ダッシュボードから保存されたアナライザーを実行します。単一のドキュメントスキーマの場合は「解析」を選択し、複数のバリアント (クライアント ABC、クライアント XYZ、汎用請求書) を単一の呼び出しでルーティングする場合は「分類」を選択してください。同じアナライザー ID は、Make、Zapier、Power Automate、n8n、および REST API で使用できます。

Parseセットアップガイド

1つのスキーマから、fieldName、fieldType、fieldDescriptionを含むフィールドを抽出します。

Classify設定ガイド

アナライザーごとに複数のスキーマが存在します。バリアントごとに、分類名 + プロンプト + ドキュメントスキーマが定義されます。

見逃してはならない重要な事実

ダッシュボードでアナライザーを設定すると、ノードはそれを参照するだけです。

スキーマ、フィールド、プロンプトを一度定義しますアナライザー一覧そしてアナライザーの詳細ページ（1つのスキーマの場合は解析、複数のバリアントの場合は分類）。 n8n ノードはアナライザーをロードします AI アナライザーID ドロップダウンメニューから選択した項目を実行します。後でスキーマを編集しても、ワークフローを変更する必要はありません。

出力は動的です JSONバイナリファイルなし

トップレベルのキーは、アナライザーで定義したフィールド名（文字列、数値、日付、またはテーブル行）と一致します。 _メタデータ オブジェクトには常に成功、メッセージ、タイムスタンプ、ソースファイル名、アナライザーID、および操作が追加されます。 出力バイナリフィールド名。

解析と分類のどちらを選択するかは、ノードではなくアナライザーによって決定されます。

同じノード、2つのアナライザーモード。解析アナライザーは、その単一スキーマからフィールドを返します。分類するアナライザーはドキュメントを最も一致するスキーマにルーティングし、その分類名を返します。 プラス 一致したスキーマから抽出されたフィールド。IDを切り替えることで動作を切り替えます。

AI Document Parser n8n ノードには、認証情報 Pdf4me、リソース Extract、抽出操作 AI Document Parser、入力データタイプ Binary Data、入力バイナリフィールド data、ドキュメント名 document.pdf、および AI Analyzer Id ドロップダウン（必須項目として強調表示）が表示されます。 — フルノードパネル: 抽出 → AI バイナリデータ入力によるドキュメントパーサー。 **AI アナライザーID** 実行前に。

パラメータ

このガイドで使用するダッシュボードのURL：

アナライザーリスト（ステップ 1–2）： https://dev.pdf4me.com/dashboard/#/ai-document-parser/
分析装置の詳細（ステップ 3–5）： https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid>

必須 n8n UI: 接続に使用する認証情報、入力データタイプ、ドキュメント名、 AI アナライザー ID。条件付き必須フィールド (入力バイナリフィールド、Base64 ドキュメントコンテンツ、またはドキュメント URL) は、一致する入力データタイプが選択された場合にのみ表示されます。 出力バイナリフィールド名 そしていいえ 詳細オプション／カスタムプロファイル この作戦において。

パラメータ	必須	その機能	例
Input Data Type	Required	How the document is supplied. Binary Data reads from a previous node (most common). Default is `Binary Data`. Base64 String accepts an encoded document. URL downloads the document from a public link.	`Binary Data`
Input Binary Field	Conditional	Name of the binary property on the incoming n8n item that holds the document. Required when Input Data Type is Binary Data. Defaults to data. Error reports which property was missing when the name is wrong.	`data`
Base64 Document Content	Conditional	Base64-encoded document. Required when Input Data Type is Base64 String. Data-URL style prefixes (text before the comma) are stripped automatically.	`JVBERi0xLjQK...`
Document URL	Conditional	Publicly reachable HTTPS URL to the document. Required when Input Data Type is URL. Must be a valid full URL.	`https://example.com/document.pdf`
Document Name	Required	Filename used by PDF4me for processing. Default is `document.pdf`. With Binary Data, the uploaded file name is used for upload but your explicit Document Name value takes precedence in the API call when set. Use a real extension (.pdf, .png, .jpg, etc.) so PDF4me handles the file correctly.	`document.pdf`
AI Analyzer Id	Required	The saved Analyzer that controls extraction. Create Analyzers at `https://dev.pdf4me.com/dashboard/#/ai-document-parser/` (+ Add), then edit schemas on `https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid>`. Dropdown populated via GetAnalyzerId API. Sent as `customisationNote`. Pick Parse for one schema or Classify for many variants.	`aaaa133`

入力データタイプのオプション

ドキュメントがノードに入力される方法を選択してください。この選択によって、後続のフィールドが変更されます。

n8n PDF4me AI Document Parserノードの入力データタイプのドロップダウンには、次の3つのオプションが表示されます。バイナリデータ（説明付きで強調表示）前のノードのドキュメントファイルを使用する、Base64文字列（説明付きで強調表示）ドキュメントの内容をBase64エンコードされた文字列として提供する、URL（説明付きで強調表示）ドキュメントファイルのURLを提供する。 — 入力データタイプ。バイナリデータ（デフォルト）、Base64文字列、または URL。

バイナリデータデフォルト: 前のノードからのファイル

Google Drive Download などの前のノードからドキュメントを直接読み取ります。 HTTP リクエスト、バイナリファイルの読み取り、またはメール添付ファイルノードを設定します。 入力バイナリフィールド バイナリフィールド名（デフォルト） データ) ドキュメント名を上書きしない限り、アップロードされたファイル名が使用されます。

Base64文字列エンコードされたドキュメントをインラインで表示

base64文字列を貼り付けるかマッピングして Base64ドキュメントの内容データURLスタイルの接頭辞（カンマより前のテキスト）は自動的に削除されます。 文書名 適切な拡張ドライブのフォーマット検出機能付き。

URL公開リンクからダウンロード

公共の HTTPS URL で ドキュメントのURL。 PDF4me ドキュメントを直接取得します。処理するファイル名は、 URL 可能な場合はパス、またはドキュメント名から取得します。

AI アナライザーIDドロップダウン

ドロップダウンリストはあなたの PDF4me アカウント経由で GetAnalyzerId API フィールドを開くと、各オプションは、 PDF4me ダッシュボード。処理対象のドキュメントタイプとスキーマが一致するものを選択してください。

n8n PDF4me AI Document ParserノードでAI Analyzer Idドロップダウンが開き、3つのアナライザーオプションの例が表示されます: aaaa133、TestTenantProject、TestTenant — AI アナライザー ID ドロップダウンは、 PDF4me アカウント。

構文解析ツール

1 つのドキュメントスキーマ。このノードは、そのスキーマで定義されたフィールドを正確に返します。処理するすべてのドキュメントが同じレイアウトファミリーを共有している場合に最適です。 Parseセットアップガイドスキーマルールを含む フィールドタイプ: "テーブル" ネストされた行と フィールドメソッド （デフォルトを抽出し、派生/正規化のために生成する）。

分類アナライザー

ドキュメントバリアントごとに1つずつ、多数のスキーマ。 AI 受信ドキュメントを各スキーマの分類プロンプトを使用して最も一致するスキーマにルーティングし、一致した分類名とそのフィールドを返します。 Classify設定ガイド。

ドロップダウンメニューが空ですか？ ノードは表示します 「GetAnalyzerId はアナライザーオプションを返しませんでした」 アカウントにアナライザーがない場合、または認証情報が到達できない場合 API. 開くアナライザー一覧アナライザーを少なくとも 1 つ追加します。アナライザーの詳細ページを確認してから、 API 入力 n8n 資格情報。

出力フィールド

成功したランは1 n8n アイテム JSON バイナリファイルはありません。トップレベルのキーはアナライザーのスキーマと一致します。 _metadata オブジェクトは常に追記されます。

分野	タイプ	内容物
`Top-level extracted fields`	Dynamic	One key per field defined in your Analyzer schema (string, number, date, or nested table rows). Names match fieldName exactly.
`_metadata.success`	Boolean	true on a successful parse.
`_metadata.message`	String	"Document parsed successfully using AI Document Parser".
`_metadata.processingTimestamp`	String	ISO timestamp of the parse.
`_metadata.sourceFileName`	String	Document name used for processing.
`_metadata.aiAnalyzerId`	String	The Analyzer Id you selected (sent as customisationNote to the API).
`_metadata.operation`	String	"aiDocumentParser".
`rawContent (fallback only)`	String	If the API returns plain text instead of JSON and parsing fails, the node wraps the response as { "rawContent": "<api response string>" } at the top level.

クイックセットアップ

まずアナライザーを構築します。アナライザー一覧、クリック +追加明確なアナライザーIDを入力し、解析または 分類する行を保存してから、ドキュメントスキーマを追加します。アナライザーの詳細ページを参照してください。 Parseセットアップガイドまたは Classify設定ガイド完全なスキーマルールについては、以下を参照してください。 fieldType: "table" ネストされた行と fieldMethod （抽出または生成）
あなたの n8n ワークフロー、クリック + そして検索する PDF4me。セット リソース に 抽出する そして 抽出操作 に AIドキュメントパーサー。
で 接続するための認証情報選択してください PDF4me 資格情報または貼り付け API 鍵。
セット 入力データタイプバイナリデータ（デフォルト）は前のノードから読み取り、最も一般的です。
一致する入力フィールドに入力してください（入力バイナリフィールド、 Base64ドキュメントの内容、または ドキュメントのURL)
文書名デフォルト設定を上書きする document.pdf 正しい拡張子を付けた実際のファイル名を使用する。
選択してください AI アナライザーID ドロップダウンメニューから選択してください（アカウントから読み込まれます）。
ノードを実行します。出力項目には、最上位レベルの解析済みフィールドに加えて、 _metadataSet、Code、Google Sheets、Airtable、データベース、メール、または任意のダウンストリームノードにルーティングします。

典型的な構成

ワークフローの例Common n8n workflow patterns using AI Document Parser.

Googleスプレッドシートへのメール添付ファイル

メールトリガー（IMAP）は新しいメッセージを受信すると作動します。 PDF 添付ファイル。
AI ドキュメントパーサーは、入力データタイプがバイナリデータ、ドキュメント名が添付ファイル名に設定された状態で実行されます。 AI アナライザーIDをあなたの 請求書パーサー 分析装置。
Googleスプレッドシート 追加する 請求書番号、ベンダー名、合計金額、支払期日をAPトラッカーに書き込みます。

Classifyによる複数ベンダー対応の受信トレイ

監視フォルダには様々な情報が届きます PDFs クライアントABC、クライアントXYZ、そしてロングテールから。
AI ドキュメントパーサーは、分類アナライザーID（ベンダーごとに1つのスキーマ）に設定されています。
Switchノードは、応答で返された一致する分類名に基づいて分岐し、それぞれの結果を対応する下流テーブルに送信します。

ホストされているドキュメント URL

Webhookは、ポータルからドキュメントリンクを受信します。
AI ドキュメントパーサーは入力データタイプで実行されます URL そして、カスタムフォームのアナライザーID。
出力 JSON Dataverse / Airtable / Postgres に書き込み、新しいレコードを作成します。

スキャン、自動トリミング、そして解析

スキャナーの出力は、幅の広い枠で囲まれたフォルダに保存されます。
AIによる文書の自動トリミング （リソース AI) 境界線をトリミングします。
AI ドキュメントパーサーは、一致するアナライザーIDを持つ切り抜きバイナリに対して実行されます。
解析済み JSON 通常通り下流へ流れます。

検証してから強化する

AI ドキュメントパーサーは構造化されたフィールドを返します。
コードノードは、必須フィールドを検証し、ビジネスルールを適用します。
有効な場合、 HTTP リクエストにはCRMからのベンダーデータが反映されます。反映されない場合は、手動レビューのためにSlackにアラートが送信されます。

実践的なヒント

Set up the Analyzer in PDF4me first

The node does not define extraction rules. It runs whatever your selected Analyzer specifies. Build it in the dashboard before configuring the node.

Use Document Name with the real extension

PDF4me uses the extension for format detection. Even on Binary Data, an explicit Document Name with the correct extension is safest.

No Output Binary Field Name and no Advanced Options

Unlike AI Auto Crop Document, this operation has neither. The output is JSON only; there is nothing to write back as a binary file.

Plain-text fallback wraps as rawContent

If the API returns plain text instead of JSON and parsing fails, the node wraps the response as { "rawContent": "<string>" } so the workflow does not break.

Combine with AI Auto Crop Document for scans

Scans with wide borders parse better after cropping. Chain AI Auto Crop Document (Resource AI) before this node.

Use AI-Invoice Parser / AI-Process Contract for built-in schemas

When you only need standard invoice or contract fields, the dedicated nodes are simpler. AI Document Parser shines when you have a custom schema.

トラブルシューティング

「AI アナライザーIDが必要です

実行前にドロップダウンリストからアナライザーを選択してください。このフィールドは空欄にできません。

プロパティ「…」にバイナリデータが見つかりませんでした。

整列 入力バイナリフィールド 前のノードと（多くの場合） データエラーメッセージには、どのプロパティが欠落していたかが報告されます。

「文書の内容は必須です」

base64データが空であるか、ファイルが見つかりません。該当する入力データタイプフィールドにコンテンツを入力してください。

"無効 URL フォーマット

チェック ドキュメントのURL 完全で有効な URL (スキーム + ホスト + パス)

「GetAnalyzerId はアナライザーオプションを返しませんでした」

アカウントにアナライザーがないか、認証情報に問題があります。アナライザーをアカウントに作成してください。 PDF4me ダッシュボードまたは確認 API キー n8n 資格情報。

チートシート

分野	価値
Resource	`Extract`
Operation	`AI Document Parser`
Input Data Type	`Binary Data`
Input Binary Field	`data`
Document Name	`form.pdf (with the real extension)`
AI Analyzer Id	`(pick from the dropdown loaded from your account)`
Credentials	`PDF4me API credential`

よくある質問

Where does the AI Analyzer Id list come from?+

The dropdown is populated from your PDF4me account via the GetAnalyzerId API. Each option is an Analyzer you created at https://dev.pdf4me.com/dashboard/#/ai-document-parser/ with schemas on https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid>. The node sends the selected value as customisationNote to the AiDocumentParser API.

What does "GetAnalyzerId returned no analyzer options" mean?+

The account has no Analyzers configured, or the credentials cannot reach the GetAnalyzerId endpoint. Open https://dev.pdf4me.com/dashboard/#/ai-document-parser/ and create at least one Analyzer (Parse or Classify) on the Analyzer detail page, or verify the API key in your n8n credential.

How is this different from AI-Invoice Parser, AI-Process Contract, AI-Process Bank Cheque?+

Those nodes use fixed schemas tuned to those document types. AI Document Parser is schema-driven: it runs whatever Analyzer you select, so the same node handles invoices, purchase orders, receipts, custom forms, lab reports, anything you describe in a schema. Pick AI Document Parser whenever you need a custom layout or document type.

What shape does the output have?+

Top-level keys match the field names in your Analyzer schema (for example customerName, invoiceNumber, totalAmount, lineItems). Nested objects and table arrays follow the same shape you defined. A _metadata object is always appended with success, message, processingTimestamp, sourceFileName, aiAnalyzerId, and operation. No binary file is returned.

Does this work on scanned PDFs?+

Yes. The AI engine handles OCR internally, so scanned PDFs and image formats work the same as native PDFs. If borders are large, chain AI Auto Crop Document (Resource AI) before this node for cleaner extraction.

Can I change the Analyzer schema without rebuilding the workflow?+

Yes. The workflow only references the Analyzer Id. Edit the schema in the PDF4me dashboard and the next run picks up the new shape automatically. Output keys follow your latest schema, so any downstream Set / Code / Sheets nodes that assume specific keys may need updating after a breaking schema change.

Can I switch between Parse and Classify Analyzers without rewiring the node?+

Yes. Both Analyzer types are listed in the AI Analyzer Id dropdown. Pick a Classify Analyzer when you want one node to handle several document variants; pick a Parse Analyzer for a single fixed schema. The output shape adapts to whichever you choose.

What happens when the API returns plain text instead of JSON?+

The node tries to parse it; if parsing fails, the response is wrapped as { "rawContent": "<api response string>" } at the top level so the workflow does not break. Useful for inspecting unexpected responses during development.