@parse-sdk/core

Parse documents effortlessly.

Installation

pnpm add @parse-sdk/core

Quick Start

Set PARSE_GATEWAY_API_KEY in your environment, then:

import { mistral, parse } from "@parse-sdk/core";

const result = await parse({
  provider: mistral("mistral-ocr"),
  url: "https://example.com/document.pdf",
});

result.outputs?.markdown;  // extracted text
result.stats;              // { time, cost, tokens, pages }

Providers

Mistral — has actual models

import { mistral, parse } from "@parse-sdk/core";

const result = await parse({
  provider: mistral("mistral-ocr"),
  url: "https://example.com/doc.pdf",
});

LlamaParse — single service

import { llamaparse, parse } from "@parse-sdk/core";

const result = await parse({
  provider: llamaparse(),
  url: "https://example.com/doc.pdf",
});

Datalab — single service

import { datalab, parse } from "@parse-sdk/core";

const result = await parse({
  provider: datalab(),
  url: "https://example.com/doc.pdf",
});

Gateway style — just a string

import { parse } from "@parse-sdk/core";

const result = await parse({
  provider: "mistral/mistral-ocr",
  url: "https://example.com/doc.pdf",
});

Parse from File

import { mistral, parse } from "@parse-sdk/core";

const file = new File([buffer], "document.pdf", { type: "application/pdf" });

const result = await parse({
  provider: mistral("mistral-ocr"),
  file,
});

result.outputs?.markdown;          // extracted text
result.outputs?.json?.blocks;      // structured blocks with bboxes
result.stats;                      // { time, cost, tokens }

Available Providers

| Provider | Usage | Default Provider ID | | ------------- | -------------------------- | ------------------- | | mistral | mistral("mistral-ocr") | mistral-ocr | | llamaparse | llamaparse() | llamaparse | | datalab | datalab() | datalab-marker |

Configuration

import { mistral, parse } from "@parse-sdk/core";

const result = await parse({
  provider: mistral("mistral-ocr", {
    apiKey: process.env.PARSE_GATEWAY_API_KEY,   // or set PARSE_GATEWAY_API_KEY env var
    baseURL: "https://parse.crafter.run",  // default
  }),
  url: "https://example.com/doc.pdf",
});

Types

All types are exported:

import type {
  ParseResult,
  ParseOutputs,
  ParseStats,
  ParseBlock,
  BBox,
  ProviderInstance,
  ProviderOptions,
  ProviderArg,
} from "@parse-sdk/core";

License

MIT