Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Doxtract

✓ manoonlabs.com

von manoonlabsVersion 1.2.0i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registrycom.manoonlabs/doxtract

So installierst du es

Was es kann

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

Originaltext des Herstellers

  • Verbindung Läuft in der Cloud
  • Konto oder Schlüssel Braucht Authorization
  • Kategorie Buchhaltung, Finanzen & Steuern

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-11-20

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 4/4 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Doxtract. Folge https://mcp.popnx.com/i/manoonlabs-doxtract.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/4 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (doxtract.manoonlabs.com) · ✓ Befehle geprüft am 21. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von Doxtract (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei Doxtract registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Doxtract öffnen ↗

  2. Klick auf diesen Button: Claude öffnet das Fenster zum Hinzufügen bereits ausgefüllt

    Doxtract zu Claude hinzufügen ↗

    Name und URL sind schon eingetragen. Prüfe sie und klick auf Add · bist du abgemeldet, fragt Claude zuerst nach der Anmeldung

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

    Button funktioniert nicht? Selbst ausfüllen

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4

    Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameDoxtract
    Remote MCP server URL · Adressehttps://doxtract.manoonlabs.com/mcp
  3. Im Chat einschalten

    +ConnectorsDoxtract

  4. Ausprobieren

    Nutze Doxtract und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Doxtract nutzt, oder ein Werkzeug von Doxtract in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Doxtract noch nicht verbinden

Doxtract braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die Doxtract verbinden kann

  • Du brauchst einen Schlüssel von Doxtract (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von Doxtract (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Doxtract (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Doxtract (auf der Seite des Anbieters erstellen)

B · Andere in Buchhaltung, Finanzen & Steuern, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von Doxtract (auf der Seite des Anbieters erstellen)

  1. Bei Doxtract registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Doxtract öffnen ↗

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

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

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    Doxtract sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Doxtract und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Doxtract nutzt, oder ein Werkzeug von Doxtract in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von Doxtract (auf der Seite des Anbieters erstellen)

  1. Bei Doxtract registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Doxtract öffnen ↗

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Doxtract ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Doxtract und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Doxtract nutzt, oder ein Werkzeug von Doxtract in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von Doxtract (auf der Seite des Anbieters erstellen)

  1. Bei Doxtract registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Doxtract öffnen ↗

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Doxtract ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Doxtract und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Doxtract nutzt, oder ein Werkzeug von Doxtract in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://doxtract.manoonlabs.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Doxtract nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das 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"
      }
    }
  }
}

Werte, die du selbst einträgst

  • Authorization geheim erforderlich HTTP header
    Bearer-Token. Einen mldxt_-Schlüssel erhalten Sie unter API Keys in der Doxtract-Konsole.
    Englisches Original anzeigenBearer token. Get a mldxt_ key from API Keys in the Doxtract console.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ manoonlabs.com
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.2.0
In der Registry veröffentlichti
21. Nov. 2026
Code zuletzt geänderti
21. Nov. 2026
Zuletzt geprüft
21. Nov. 2026
Entwickler
manoonlabs
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 21. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • 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.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 21. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain manoonlabs.com bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • – Nicht zutreffend

    Hat eine Lizenz

    Nicht relevant: Cloud-Server des Inhabers von manoonlabs.com; du führst keinen Code aus dem Repo aus

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 335 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 15 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

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

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

  • Mehr Sterne als 0 % der anderen 3609 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 95 % der anderen 3609 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 3609 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Doxtract sicher?

Er hat 4 von 4 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (1.2.0) kam heute in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

SolidInvoice

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

von SolidInvoiceWachsend★ 989Aktualisiert vor 12 Tagen

Läuft in der Cloud✓ vom Dienst · solidinvoice.co

Journalit

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

von CursivezWachsend★ 265Aktualisiert vor 13 Tagen

Läuft in der Cloud✓ vom Dienst · journalit.co

Beancount.io

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

von bex-coWachsend★ 723 Sterne des ganzen ReposAktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · beancount.io

Twelve Data

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

von twelvedataWachsend★ 87Aktualisiert vor 17 Tagen

Läuft in der Cloud✓ vom Dienst · twelvedata.com
Im Vergleich mit ähnlichen
Dieser
Doxtract
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinJaNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinJa
Basisprüfungen4/44/64/44/45/54/4
LizenzMITMITNOASSERTIONMITMIT–
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo