ドキュメントパース

Firecrawl は強力なドキュメント解析機能を備えており、さまざまなドキュメントフォーマットから構造化コンテンツを抽出できます。この機能は、スプレッドシートや Word 文書などのファイルを処理する際に特に有用です。

Firecrawl は現在、以下のドキュメントフォーマットをサポートしています：

• Excel スプレッドシート (.xlsx, .xls)

  • 各ワークシートを HTML テーブルに変換します
  • ワークシートはシート名の H2 見出しで区切られます
  • セルの書式とデータ型を保持します

• Word ドキュメント (.docx, .doc, .odt, .rtf)

  • ドキュメント構造を保ちながらテキストコンテンツを抽出します
  • 見出し、段落、リスト、表を保持します
  • 基本的な書式とスタイルを保持します

• PDF ドキュメント (.pdf)

  • レイアウト情報とともにテキストコンテンツを抽出します
  • セクションや段落を含むドキュメント構造を保持します
  • テキストベースおよびスキャン PDF の両方に対応します (OCR 対応)
  • 解析方法を制御するための mode オプションをサポートします：fast (テキストのみ) 、auto (必要に応じて OCR を行うテキスト、デフォルト) 、ocr (OCR のみを使用)
  • 料金は1ページあたり1クレジットです。詳細は Pricing を参照してください。

PDF の処理方法を制御するには、parsers オプションを使用します:

// モード指定のオブジェクト構文
parsers: [{ type: "pdf", mode: "ocr", maxPages: 20 }]

// デフォルト（autoモード）
parsers: [{ type: "pdf" }]

Firecrawl のドキュメントパースは、次の 2 通りで利用できます。

1. URL ベースの解析 (/v2/scrape): 対応するドキュメント形式を指す URL を指定します。
2. ファイルアップロードによる解析 (/v2/parse): multipart/form-data を使って、ファイルのバイト列を直接アップロードします。

URL ベースの解析では、Firecrawl が拡張子またはコンテンツタイプからファイル形式を自動的に判別します。

元のドキュメントがローカルにある場合、または URL 経由で一般公開されていない場合は、/v2/parse を使用します。

curl -X POST "https://api.firecrawl.dev/v2/parse" \
  -H "Authorization: Bearer fc-YOUR-API-KEY" \
  -F 'options={"formats":["markdown"]}' \
  -F "file=@./document.docx;type=application/vnd.openxmlformats-officedocument.wordprocessingml.document"

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({
  // 開始にAPIキーは不要です — より高いレート制限が必要な場合は追加してください:
  // apiKey: "fc-YOUR-API-KEY",
});

const doc = await firecrawl.scrape('https://example.com/data.xlsx');

console.log(doc.markdown);

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({
  // 開始にAPIキーは不要です — レート制限を引き上げるには追加してください:
  // apiKey: "fc-YOUR-API-KEY",
});

const doc = await firecrawl.scrape('https://example.com/data.docx');

console.log(doc.markdown);

サポートされているすべてのドキュメントタイプは、クリーンで構造化されたmarkdownに変換されます。たとえば、複数のシートを含むExcelファイルは、次のように変換されることがあります。

## Sheet1

| Name  | Value |
|-------|-------|
| Item 1 | 100   |
| Item 2 | 200   |

## Sheet2

| Date       | Description  |
|------------|--------------|
| 2023-01-01 | First quarter|

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