Let's Build: Transloadit による AI 履歴書パーサー
PDF または DOCX の履歴書から、連絡先、スキル、職歴、学歴を含むローカルの JSON ファイルを作成します。この TypeScript サンプルは Transloadit を使い、必要に応じて文書を変換してから、AI モデルでフィールドを抽出します。このサイトのリポジトリがなくても新しいディレクトリから実行でき、保存した結果を原本と比較できます。
作成するもの
- PDF または DOCX の履歴書を 1 件受け付け
- 🤖 /document/convert で DOCX を PDF に変換
- 🤖 /ai/chat でフィールドを抽出し、JSON として保存
このサンプルでは、anthropic/claude-sonnet-4-6 を選択します。これは /ai/chat 経由の PDF 入力に対応しています。画像ファイルの受け付けや候補者の順位付けは行いません。スキーマ検証で確認するのは応答の構造であり、抽出情報の正しさではありません。
スキーマから開始(zod)
サンプルスクリプト は、モデルへのリクエストとローカルでの検証の両方に使うスキーマをエクスポートします。後述のアプリをダウンロードしたら、次の内容をプロジェクトルートに
inspect-schema.ts として保存し、node inspect-schema.ts を実行します。
import { zodToJsonSchema } from 'zod-to-json-schema'
import { resumeSchema } from './resume-parser/run.ts'
const resumeJsonSchema = zodToJsonSchema(resumeSchema)
console.log(JSON.stringify(resumeJsonSchema, null, 2))
応答ではすべてのフィールドが必須です。不明なテキストには空文字列を、項目のないリストには空配列を使います。スキーマには連絡先や職歴のフィールドのほか、summary、certifications、links が含まれますが、信頼度スコアは返しません。抽出結果がすべて空の場合は拒否されますが、もっともらしい誤った値は検証を通過することがあります。
パイプラインの概要
PDF resumes ──▶ /ai/chat ──▶ local JSON
DOCX resumes ──▶ /document/convert (pdf) ──▶ /ai/chat ──▶ local JSON
Assembly のスニペット
Assembly を送信せずに実際の Step を確認するには、次の内容を同じプロジェクトルートに inspect-steps.ts として保存し、node inspect-steps.ts を実行します。
import { example } from './resume-parser/run.ts'
const steps = example.steps({ test_credentials: true })
console.log(JSON.stringify({ steps }, null, 2))
この処理設定は、アップロードされた PDF を pdf_verified に振り分け、それ以外の受け付け対象文書を pdf_converted で変換します。extract_resume Step はこれらの出力を受け取り、シリアライズしたスキーマで JSON を要求します。この設定を組み立てるだけでは API リクエストは発生しません。CLI がアップロード、待機、結果のダウンロード、保存前の検証を処理します。
サンプルアプリの試用
新しい空のディレクトリで、セットアップ手順を最後まで実施してください。この手順では、テスト済みの組み合わせである @transloadit/node 4.14.0、Zod 3.25.76、zod-to-json-schema 3.25.2 を Yarn 4.12.0 でインストールします。このチュートリアルは Node.js 26.12.1 でテストしました。README の前提条件を満たす、メンテナンス中の Node.js リリースを使ってください。Corepack と cURL も必要です。これらは再現用のバージョンであり、最新版を示すものではありません。
この既存の実行スクリプトは、Zod 3 スキーマと非推奨の JSON Schema コンバーターを使います。再現する場合は、記載の固定バージョンを維持してください。アプリを Zod 4 に対応させるには、スキーマ変換の更新も必要であり、インストールするメジャーバージョンの変更だけでは不十分です。
README のコマンドで、resume-parser/run.ts と shared/runtime.ts の両方をダウンロードしてください。パーサーは共有ランタイムをインポートするため、相対的な配置が重要です。初回テストに既存のパッケージマネージャー設定が影響しないよう、既存プロジェクトの外でセットアップを実行してください。README の最後の --help コマンドは、何もアップロードせずにアプリを起動します。
セットアップでは、既存ファイルを置き換えずに package.json を作成します。インストールやダウンロードが途中で停止した場合は、そのディレクトリを調査用に残し、別の空のディレクトリでやり直してください。
アプリを実行するシェルで、Transloadit Workspace の Auth Key と Auth Secret をそれぞれ
TRANSLOADIT_AUTH_KEY と TRANSLOADIT_AUTH_SECRET としてエクスポートしてください。これらの値はソース管理に含めないでください。スクリプトはプロセスの環境変数を読み取り、環境変数ファイルは読み込みません。
次のコマンドでは、TRANSLOADIT_AI_CREDENTIALS を未設定のままにしてください。--test-credentials は、Transloadit 提供の AI 認証情報を明示的に選択します。AI テスト認証情報の使用と、ほかの処理 Step は課金対象です。代わりに、既存の Anthropic AI 認証情報名を TRANSLOADIT_AI_CREDENTIALS に指定し、フラグを省略することもできます。モードは必ずどちらか一方だけを選択してください。プログラムは認証情報の作成や変更を行いません。選択前に AI 認証情報のドキュメントを確認してください。
アップロードする権限のある履歴書を resume.pdf に配置し、次を実行します。
node resume-parser/run.ts --input ./resume.pdf --output ./result.json --test-credentials
実行するたびに新しい保存先を使ってください。アプリは Assembly を送信する前に既存の出力先を拒否し、入力ファイルには変更を加えません。このチュートリアルでは、入力とダウンロードする出力をそれぞれ 20 MiB に制限しています。これはサンプルの制限であり、Transloadit 製品の制限ではありません。処理の待機時間は 5 分、結果のダウンロードの待機時間は 30 秒です。
成功すると、ターミナルに Assembly ID と Saved メッセージが表示され、その後にローカルの出力パスが続きます。そのファイルを確認してください。
cat ./result.json
ATS にインポートする前に、氏名、メールアドレス、スキル、日付、職歴の各項目を原本と照合してください。Assembly の成功や JSON を読み取れることだけでは、抽出の正確さを裏付けられません。個人情報を含む保存ファイルは非公開にしてください。
Assembly ID が表示された後に実行が失敗した場合は、再試行する前に Console でその Assembly を確認してください。ローカルでのタイムアウトや中断は、リモート処理の停止を意味せず、処理料金が発生することもあります。スクリプトは Assembly を自動で再試行しません。結果の検証失敗を処理する際は、未完成の出力を削除し、既存の保存先は保持します。中断によって不完全なローカルファイルが残ることがあるため、新しい保存先を選ぶ前に確認してください。
入力例
まず、架空の履歴書を PDF または DOCX で作成してください。たとえば、氏名を「Jamie Example」、メールアドレスを jamie@example.test、スキルを「TypeScript」と「PostgreSQL」とし、「Example Systems」での職歴を 1 件記載します。その職歴には「社内文書検索サービスを構築」のような具体的な実績を加えてください。こうした既知の情報を使えば、実在する人物の情報をアップロードせずに保存結果を確認できます。
変換処理の分岐を試すには、--input ./resume.pdf を DOCX のパスに置き換えてください。同じ CLI と JSON スキーマを使います。文書のレイアウトやモデルの推論が結果に影響することがあるため、サンプルの成功を精度の保証とみなさず、出力を毎回確認してください。
次のステップ
電話番号と日付の正規化は、元の値を確認してから行ってください。空のフィールドは情報の欠落として扱い、不確かな抽出結果は手動レビューに回してください。サンプルスクリプトを ATS 向けに調整する際も、抽出とインポートの間にこのレビュー手順を残してください。
