ドキュメントパース

ドキュメントのパース機能について学ぶ

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

​

サポートされているドキュメントフォーマット

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

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

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

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

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

• PowerPoint プレゼンテーション (.pptx, .ppt, .pptm, .odp)

  • スライドコンテンツを読み取り順に抽出します
  • 発表者ノートを含みます

• EPUB 電子書籍 (.epub)

  • ドキュメント構造を保ちながら章のコンテンツを抽出します

• CSV ファイル (.csv)

  • テーブルに変換されます

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

  • レイアウト情報とともにテキストコンテンツを抽出します
  • セクションや段落を含むドキュメント構造を保持します
  • テキストベースおよびスキャン PDF の両方に対応します (OCR 対応)
  • ページごとの任意の markdown と、バウンディングボックス付きの型付きレイアウトブロックをサポートします
  • 料金は1ページあたり1クレジットです。詳細は Pricing を参照してください。
  • 解析モード、ページ上限、ページごとの markdown、レイアウトブロックを含む完全なリファレンスについては、PDF オプション を参照してください。

​

ドキュメントパースの使い方

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

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

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

​

/v2/parse でドキュメントをアップロードする

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

cURL

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"

​

例: Excel ファイルのスクレイピング

Node

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);

​

例：Word ドキュメントのスクレイピング

Node

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 を参照してください。