解析

• PDF、DOCX、XLSX、HTML などを Markdown または構造化 JSON に変換
• Rust ベースのエンジンにより、解析を最大 5 倍高速化
• 1 リクエストあたり 50 MB までのファイルに対応
• ゼロデータ保持をサポート

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

doc = firecrawl.parse("./report.pdf")

print(doc.markdown)

import Firecrawl from "@mendable/firecrawl-js";
import fs from "node:fs";

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

const doc = await firecrawl.parse({
  data: fs.readFileSync("./report.pdf"),
  filename: "report.pdf",
});

console.log(doc.markdown);

curl -X POST https://api.firecrawl.dev/v2/parse \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@./report.pdf' \
  -F 'options={"formats":["markdown"]};type=application/json'

{
  "success": true,
  "data": {
    "markdown": "# Annual Report\n\n...",
    "metadata": {
      "title": "Annual Report",
      "numPages": 42,
      "sourceFile": "report.pdf"
    }
  }
}

• formats: 出力フォーマットの配列。デフォルトは ["markdown"]。対応フォーマット: markdown、html、rawHtml、links、images、summary、json (スキーマまたはプロンプト付き) 。
• onlyMainContent: ドキュメントのメインコンテンツのみを返します。デフォルトは true。
• includeTags / excludeTags: タグ単位での含める/除外の指定 (HTML 入力) 。
• timeout: リクエストのタイムアウト (ミリ秒) 。デフォルトは 30000、最大 300000。
• parsers: ファイル解析の制御。PDF の場合は、{ "type": "pdf", "mode": "fast" | "auto" | "ocr", "maxPages": <int> } を設定します。

curl -X POST https://api.firecrawl.dev/v2/parse \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@./scan.pdf' \
  -F 'options={"parsers":[{"type":"pdf","mode":"ocr","maxPages":50}]};type=application/json'

• fast: テキストのみを提取する最速の方法です。
• auto (デフォルト) : テキスト優先で処理し、画像のみのページでは OCR にフォールバックします。
• ocr: すべてのページで OCR を実行します — スキャン文書に使用してください。

curl -X POST https://api.firecrawl.dev/v2/parse \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@./invoice.pdf' \
  -F 'options={"formats":[{"type":"json","schema":{"type":"object","properties":{"total":{"type":"number"},"vendor":{"type":"string"}}}}]};type=application/json'

• 1 リクエストあたりの最大ファイルサイズは 50 MB です。
• ocr モードで非常に大きい PDF やスキャンされた PDF をパースする場合、時間がかかることがあります。timeout を長めに設定するか、maxPages を使って処理範囲を制限してください。
• 複数ファイルを扱う場合は、各ファイルに対して /parse を並列に呼び出してください。バッチアップロード用のバリアントはありません。

Firecrawl APIキー が必要な AIエージェントですか？自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。