プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Doxtract

✓ manoonlabs.com

作者:manoonlabsバージョン 1.2.0i★ 0iクラウドで動く公式サイト ↗
レジストリ名com.manoonlabs/doxtract

インストール方法

できること

Invoices, receipts and statements into clean rows you can check and export. REST API and MCP.

作者による原文

  • 接続方法 クラウドで動く
  • アカウントまたはキー Authorization が必要
  • カテゴリ 会計・財務・税務

この順位の理由

これは「AI につながるアプリ」タブにあり、スターを使わず次の順で並びます

1. Claude のコネクタディレクトリにあるいいえ
2. チームが実際に試したいいえ
3. タイのユーザー向けいいえ
4. スターを除いた利用状況20/100人気 0 · 新しさ 12 · 応答中 8 · ユーザーのいいね +0
5. 登録日2026-11-20

ユーザーのいいね: 0 · 順位に最大 5 点(1 人 1 点)加算。お金では買えません。

品質: 基本チェック 4/4 項目に合格(表示のみ、並び順には不使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Doxtract をインストールして。https://mcp.popnx.com/i/manoonlabs-doxtract.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 4/4 合格 · 質問内容は提供元のサーバー(doxtract.manoonlabs.com)を通ります · ✓ コマンド確認済み 2026年11月21日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 5 分

Doxtract のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Doxtract に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Doxtract のサイトを開く ↗

  2. このボタンを押すと、Claude が入力済みの connector 追加画面を開きます

    Doxtract を Claude に追加 ↗

    名前と URL は入力済みです。確認して Add を押します · ログインしていなければ、先にログインを求められます

    Request headers に、この名前と値を追加

    ヘッダー名Authorization
    値Bearer <ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

    ボタンが動かない?手動で入力する

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4

    「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Doxtract
    Remote MCP server URL · アドレスhttps://doxtract.manoonlabs.com/mcp
  3. チャットで有効にする

    +ConnectorsDoxtract

  4. 試してみる

    Doxtract を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Doxtract を使っていると言うか、回答に Doxtract のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Doxtract につなげません

Doxtract は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · Doxtract につなげるアプリを使う

  • Doxtract のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • Doxtract のキーが必要です(提供元のサイトで作成)
  • Doxtract のキーが必要です(提供元のサイトで作成)
  • Doxtract のキーが必要です(提供元のサイトで作成)

B · 会計・財務・税務 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげます · 約 5 分

Doxtract のキーが必要です(提供元のサイトで作成)

  1. Doxtract に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Doxtract のサイトを開く ↗

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user doxtract https://doxtract.manoonlabs.com/mcp --header 'Authorization: Bearer your-value'

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    Doxtract が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Doxtract を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Doxtract を使っていると言うか、回答に Doxtract のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 5 分

Doxtract のキーが必要です(提供元のサイトで作成)

  1. Doxtract に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Doxtract のサイトを開く ↗

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. キーを入力

    Doxtract の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    Doxtract を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Doxtract を使っていると言うか、回答に Doxtract のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 5 分

Doxtract のキーが必要です(提供元のサイトで作成)

  1. Doxtract に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Doxtract のサイトを開く ↗

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. キーを入力

    Doxtract の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    Doxtract を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Doxtract を使っていると言うか、回答に Doxtract のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://doxtract.manoonlabs.com/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Doxtract を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user doxtract https://doxtract.manoonlabs.com/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "doxtract": {
      "url": "https://doxtract.manoonlabs.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "doxtract": {
      "type": "http",
      "url": "https://doxtract.manoonlabs.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

自分で入力する値

  • Authorization 秘密 必須 HTTP header
    Bearer トークン。Doxtract コンソールの API Keys から mldxt_ キーを取得してください。
    英語の原文を見るBearer token. Get a mldxt_ key from API Keys in the Doxtract console.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
確認済みドメイン
✓ manoonlabs.com
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
1.2.0
レジストリ公開日i
2026年11月21日
コードの最終更新i
2026年11月21日
最終確認
2026年11月21日
作者
manoonlabs
ウェブサイト
doxtract.manoonlabs.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月21日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • whoami

    Return the workspace and token for the bearer credential, and the credits left this month.

  • parse_document

    Extract structured fields from a PDF, PNG, JPEG, or text file sent as base64 in file_base64, or from plain text sent in text (10 MB and 10 pages on Free, 25 MB on Starter and Pro, 100 MB on Business; pages per document by plan: Starter 50, Pro 200, Business 500). 1 credit per pag

  • list_schemas

    List the extraction layouts saved in this workspace.

  • get_schema

    Read one saved extraction layout by slug.

  • create_schema

    Save an extraction layout in this workspace. The slug (API id) is derived from the display name. A layout is {"type":"object","properties":{...}}. Each property is {"type":T} where T is one of any, null, boolean, string, number, date, array, object. An optional description, at mo

  • update_schema

    Update a saved layout's display name and/or definition. A layout is {"type":"object","properties":{...}}. Each property is {"type":T} where T is one of any, null, boolean, string, number, date, array, object. An optional description, at most 400 characters, tells the model how to

  • list_inboxes

    List the inboxes this key can see, newest first, up to 200. Each has its id, name, icon, status, document count and email address. A key limited to some inboxes sees only those.

  • get_inbox

    Read one inbox: its name, icon, status, document count, email address, and its fields as a JSON schema (schema, null for a draft with no fields yet). The fields show what kind of document the inbox reads, so use them to decide which inbox a document belongs in.

  • upload_document

    Add one document to an inbox. It is read with the inbox's fields in the background, the same as a document dropped into the inbox in the console, and costs 1 credit per page. Send the file as file_base64 (a PDF, PNG or JPEG) with its file_name. Returns the new document's id. Uplo

  • create_inbox

    Create an inbox in this workspace and return its id and email address. Send template (a built-in template slug: invoice, receipt, bank_statement, purchase_order) to make it ACTIVE with that template's fields, the same as creating one in the console. Without a template it is a DRA

  • create_inbox_from_schema

    Create an active inbox from a schema you send, in the same format as a saved layout. The inbox gets its own fields, its email address is returned, and mail and uploads are parsed at once. This path is for the API and MCP only; the console does not offer it.

  • update_inbox

    Change an inbox's name and/or icon. Send name, icon, or both. Send icon as null to go back to the default icon. Renaming does not change the email address.

  • get_inbox_email

    Read an inbox's email address and whether it accepts mail. The address is created the first time it is read.

  • set_inbox_email_enabled

    Turn mail receiving on or off for one inbox. The address does not change. Documents already in the inbox are not affected.

  • set_inbox_webhook

    Save where an inbox sends each parsed document, so documents that arrive by email or upload reach your system without a poll. Each body is signed with the returned secret. An empty url turns the webhook off. Only a key created by the workspace owner can change it.

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月21日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン manoonlabs.com で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • – 対象外

    ライセンスがある

    対象外:manoonlabs.com の所有者が自ら運営するクラウドのサーバーで、リポジトリのコードを実行しません

  • ✓ 合格

    エンドポイントが応答する

    335ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    15件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/manoonlabs-doxtract.svg)](https://mcp.popnx.com/en/servers/manoonlabs-doxtract)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

会計・財務・税務のほかのサーバーとの比較i

  • このカテゴリのほかの3609件のうち0%よりスターが多い
  • このカテゴリのほかの3609件のうち95%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3609件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Doxtractは安全ですか?

当てはまる基本チェック4項目のうち4項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:Authorization

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(1.2.0)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

作者:SolidInvoice成長中★ 98912 日前更新

クラウドで動く✓ 提供元 · solidinvoice.co

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

作者:Cursivez成長中★ 26513 日前更新

クラウドで動く✓ 提供元 · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

作者:bex-co成長中★ 723 リポジトリ全体のスター2 か月前更新

クラウドで動く✓ 提供元 · beancount.io

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

作者:twelvedata成長中★ 8717 日前更新

クラウドで動く✓ 提供元 · twelvedata.com
似たものと比べる
これ
Doxtract
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要
キーが必要はいいいえいいえいいえはいいいえ
Claude で + から追加いいえいいえいいえいいえいいえはい
基本チェック4/44/64/44/45/54/4
ライセンスMITMITNOASSERTIONMITMIT–
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Get an API key · API docs · Playground · MCP server · Benchmark

The official JavaScript and TypeScript SDK for Doxtract. Send a PDF, scan, phone photo or text, plus the schema you want. Get back JSON in that shape. If a field isn't on the document, you get null, not a guess.

import { Doxtract } from "@manoonlabs/doxtract";

import { z } from "zod";

const doxtract = new Doxtract(); // reads DOXTRACT_API_KEY

const Invoice = z.object({ vendor: z.string().nullable(), total: z.number().nullable() });

const { values } = await doxtract.parse("invoice.pdf", { schema: Invoice }); values.total; // number | null

Contents

  • Why Doxtract
  • Benchmark
  • Citations
  • Install
  • Quick start
  • Inputs
  • Schemas
  • Excel and CSV export
  • Checking your key
  • Async jobs
  • Error handling
  • Retries, timeouts and cancellation
  • Options
  • Runtime support
  • MCP and the web app
  • Pricing
  • Development
  • License

Why Doxtract

  • It copes with messy input. Rotated pages, phone photos, scanned receipts and multi-page PDFs. That's where a plain LLM prompt starts guessing.
  • The schema drives the output. You define the fields once, as a saved schema or inline. Every response matches that shape, and arrays are always arrays.
  • Typed end to end. Pass a Zod schema and values is typed from it, or use parse () for values: T. Errors come back as classes you can instanceof.
  • Zero runtime dependencies. The only package it asks for is zod as a peer, for Zod schemas. It's built on native fetch and FormData, ships as ESM and CommonJS, and runs server-side on Node 18+, Bun and Deno.
  • One API in three places. Use it over REST (this SDK), as an MCP server for AI agents and editors, or in the web app.

Benchmark

We ran Doxtract and a plain LLM prompt over 45 public documents with the same schema, then scored every field against a hand-checked answer key.

Fields extracted correctlyDoxtractPlain LLM prompt
All fields98.7%69.7%
Rotated pages100%39.3%
Phone photos96.2%56.4%
Made-up values per 100 fields (all 50 docs)0.11.9

The method, caveats and per-document CSV are on the benchmark page.

Citations

Every extracted value links back to where it came from. Click a value to see its box on the document, or click a box to jump to the value.

In the SDK, set citations: true:

const result = await doxtract.parse("invoice.pdf", { schema: Invoice, citations: true });

result.citations?.["total"]; // { page: 1, text: "Total 1,280.50", bbox: [0.62, 0.81, 0.91, 0.84], status: "verified", source: "text_layer" }

  • Keys: one per value path, such as total or lineItems[0].amount.
  • `page` and `text`: the 1-based page and the printed text the value was read from. page is null for a text document.
  • `bbox`: [x0, y0, x1, y1] as fractions of the page from the top left, or null when there's no box.
  • `status`: verified, fuzzy, mismatch, other_page or unverified, from checking the text against the page.

Install

npm install @manoonlabs/doxtract

or

pnpm add @manoonlabs/doxtract yarn add @manoonlabs/doxtract bun add @manoonlabs/doxtract

On Deno, import npm:@manoonlabs/doxtract.

zod (version 4) is a peer dependency, used only when you pass a Zod schema. npm 7 and later and pnpm install it for you. On Yarn, run yarn add zod if you want Zod schemas. Plain schemas work without it.

Quick start

  1. Sign up and create a key on the API Keys page. The full secret is shown once.
  2. Put the key in your environment:
   export DOXTRACT_API_KEY=bk_live_...
  1. Parse a document:
   import { Doxtract } from "@manoonlabs/doxtract";

import { z } from "zod";

const doxtract = new Doxtract({ apiKey: process.env.DOXTRACT_API_KEY });

const Invoice = z.object({ vendor: z.string().nullable(), total: z.number().nullable(), });

const result = await doxtract.parse("invoice.pdf", { schema: Invoice });

console.log(result.values); // { vendor: "Northwind Supply", total: 1280.5 }

Not using Zod? Pass a plain JSON schema or a saved schema name instead. See Without Zod.

If you leave out apiKey, the client reads DOXTRACT_API_KEY, then DOC2JSON_API_KEY. If there's no key at all, the constructor throws a DoxtractError with code missing_api_key. Doc2Json and Doc2JsonError are still exported.

Want to see the output before writing code? Run a sample invoice in the Playground. No sign-in needed.

Inputs

parse() takes the document in whatever form you have it:

import { readFile } from "node:fs/promises";

// A file path (Node, Bun and Deno) await doxtract.parse("./invoice.pdf");

// Bytes: Buffer, Uint8Array or ArrayBuffer await doxtract.parse(await readFile("invoice.pdf"), { filename: "invoice.pdf" });

// A Blob or File, for example from an await doxtract.parse(input.files[0]);

// Base64 (a data: URL prefix is removed for you) await doxtract.parse({ base64: pdfBase64, filename: "invoice.pdf" });

// Plain text, such as an invoice email await doxtract.parse({ text: "Invoice INV-1042 from Northwind Supply. Total 1280.50 USD." });

  • Formats: PDF, PNG, JPEG and UTF-8 text files work. The type is read from the file bytes, not the name.
  • Limits: on the Free plan, documents can be up to 10 MB and 10 pages. Paid plans allow 25 MB and 50 pages. A document over the page limit is refused before any credit is spent.
  • Filename: this sets the document name used in your activity log and in export file names. It defaults to the file's own name.

Schemas

Without a schema, Doxtract chooses the fields. To control the output, pass a Zod schema, a plain JSON schema, or the name of a schema saved in your workspace.

Zod schemas

Pass a Zod 4 schema and values is typed with z.infer. There's no JSON to write and no generic to add. The SDK converts the schema for you:

import { z } from "zod";

const Invoice = z.object({ vendor: z.string().nullable(), total: z.number().nullable(), issued: z.iso.date().nullable(), // yyyy-mm-dd lineItems: z.array(z.object({ description: z.string(), amount: z.number() })), });

const result = await doxtract.parse("invoice.pdf", { schema: Invoice });

result.values.total; // number | null result.validation.success; // true when values match Invoice

  • Use `.nullable()` on any field that might not be on the document. Doxtract returns null for a missing value, and .nullable() keeps your types honest.
  • Hints: .describe("...") tells Doxtract how to read a field.
  • Arrays: an array field is always an array, and [] when there are no rows.
  • Validation: the result also has validation, which is schema.safeParse(values). A mismatch never throws. Check validation.success, and read validation.error.issues for the details. values is always the JSON the API sent, so read validation.data if your schema uses transforms or z.coerce.
  • Install: zod is a peer dependency. npm 7 and later install it with the SDK, so there's usually nothing to do.
  • Mapping: z.string(), z.number() (and .int()), z.boolean() and z.object() map to the same Doxtract types. z.iso.date() becomes date, sent back as a yyyy-mm-dd string. An enum becomes a string with the allowed values added to the hint, and a literal becomes its own type. .optional() drops the key from required. Shapes with no Doxtract type, such as a union of two types, z.record() or z.unknown(), become any. Checks like .min() or .regex() aren't sent, but validation still applies them.
  • Dates as `Date`: z.date() also becomes date, but the API still sends a string. Use z.coerce.date() and read validation.data to get a Date.
  • See the result: zodToSchema(Invoice) returns the definition the SDK sends.
  • zod/mini schemas work too. Zod 3 schemas don't, so upgrade to zod@4.
Without Zod

Pass the definition as a plain JSON schema object, and add the type yourself with parse ():

type Invoice = {

vendor: string | null; total: number | null; issued: string | null; // yyyy-mm-dd lineItems: { description: string; amount: number }[]; };

const result = await doxtract.parse ("invoice.pdf", { schema: { type: "object", properties: { vendor: { type: "string" }, total: { type: "number" }, issued: { type: "date" }, lineItems: { type: "array", items: { type: "object", properties: { description: { type: "string" }, amount: { type: "number" }, }, required: ["description", "amount"], }, }, }, required: ["vendor", "total"], }, });

result.values.total; // number | null

  • Field types: string, number, boolean, date, array, object, null and any.
  • Dates: a date comes back as yyyy-mm-dd.
  • Hints: add a description to any field to tell Doxtract how to read it.
  • Missing values: a value that isn't on the document is null.
  • Arrays: an array field is always an array, and [] when there are no rows.
  • No setup: plain schemas work without zod installed.
Saved schemas

Save a schema once and refer to it by name from every app, key and MCP client in the

冒頭だけを表示しています。続きはリポジトリで読めます