프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 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 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.

내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · 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 추가 창을 엽니다

    Claude에 Doxtract 추가 ↗

    이름과 주소가 채워져 있어요. 확인하고 Add를 누르세요 · 로그인하지 않았다면 Claude가 먼저 로그인을 요청해요

    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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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이 목록에 있고 연결됨으로 보이면 돼요

  5. 해 보기

    Doxtract을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ VS Code가 Doxtract을 쓰고 있다고 하거나 답에 Doxtract 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

웹으로 연결하는 앱용 주소

주소https://doxtract.manoonlabs.com/mcp

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Doxtract을 쓰는 사람에게 물어보세요💬 토론 →
개발자용: 터미널 명령과 JSON 설정

웹으로 연결

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
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 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 소유자가 직접 운영하는 클라우드 서버라 저장소 코드를 실행하지 않아요

  • ✓ 통과

    엔드포인트 응답

    335ms 만에 응답(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를 받는 앱에서도 쓸 수 있어요. 예: 웹 ChatGPT(Business 이상은 전체 MCP, Pro는 읽기 전용).

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도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

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요