クイック比較
1. /agent エンドポイント
/agent エンドポイントは、/extract の後継となる Firecrawl の最も高度な機能です。AI エージェントを使用して、自律的にウェブを横断して検索・ナビゲートし、データを収集します。
主な特長
- URL は任意:
promptに必要な内容を記述するだけでよく、URL の指定は完全に任意です - 自律ナビゲーション: エージェントがサイトを深く検索・巡回し、必要なデータを見つけます
- ディープウェブ検索: 複数のドメインやページにまたがる情報を自律的に探索・発見します
- 並列処理: 複数のソースを同時に処理し、高速に結果を返します
- 利用可能なモデル:
spark-1-mini(デフォルト、60% 低コスト) とspark-1-pro(高精度)
例
最適なユースケース: 自律的なリサーチと発見
/agent なのか: どのウェブサイトにその情報があるか分からない場合でも、Agent が自律的にウェブを検索し、関連する情報源 (Crunchbase、ニュースサイト、企業ページなど) にアクセスして、構造化データとして集約してくれる。
詳細については、Agent のドキュメントを参照してください。
2. /extract エンドポイント
代わりに
/agent を使用してください: /agent への移行を推奨します。/agent はより高速で信頼性が高く、URL を必要とせず、すべての /extract のユースケースに加えて、さらに幅広いユースケースに対応できます。/extract エンドポイントは、LLM を用いた抽出機能により、指定した URL やドメイン全体から構造化データを収集します。
主な特徴
- 通常は URL が必須: 少なくとも 1 つの URL を指定する必要があります (
example.com/*のようなワイルドカードに対応) - ドメインクロール: ドメイン内で発見されたすべての URL をクロール・解析可能
- ウェブ検索による拡張: 指定ドメイン外のリンクをたどるオプション
enableWebSearchを利用可能 - スキーマは任意: 厳密な JSON スキーマまたは自然言語プロンプトのどちらにも対応
- 非同期処理: ステータス確認用のジョブ ID を返却
URL の制約
/extract の根本的な課題は、通常は事前に URL を把握しておく必要があることです:
- 発見のギャップ: 「YC W24 の企業を探す」のようなタスクでは、どの URL にデータが含まれているか分かりません。
/extractを呼び出す前に、別途検索ステップが必要になります。 - 扱いづらい Web 検索:
enableWebSearchは存在しますが、指定した URL からしか開始できず、探索タスクには不自然なワークフローになります。 /agentが作られた理由:/extractは既知の場所からの抽出には向いていますが、データがどこに存在するかを見つける用途にはあまり向いていません。
使用例
最適なユースケース: ターゲットを絞ったマルチページ抽出
docs.competitor.com/* からすべての API エンドポイントを抽出したい場合。
ここで /extract が有効だった理由: 対象のドメインが正確に分かっていたためです。ただし、その場合でも、現在では URL を指定して /agent を使うほうが、一般的により良い結果が得られます。
詳細については、Extract のドキュメントを参照してください。
3. JSONモード付きの /scrape エンドポイント
/scrape エンドポイントは、最も制御しやすいアプローチです。特定の1つのURLから構造化データを抽出し、ページ内容をLLMでパースして、指定したスキーマに変換します。
主な特長
- 単一URLのみ: 一度に特定の1ページからデータを抽出するよう設計されています
- 正確なURLが必要: データを含む正確なURLを把握している必要があります
- スキーマは任意: JSON Schemaを使うことも、プロンプトだけを使うことも可能 (LLMが構造を選択)
- 同期処理: データを即時に返します (ジョブのポーリングは不要)
- 追加フォーマット: 1つのリクエストでJSON抽出をmarkdown、HTML、スクリーンショットと組み合わせ可能です
使用例
最適なユースケース:単一ページの高精度抽出
/scrape と JSONモードなのか: どのページにデータがあるかを正確に把握しており、単一ページから高精度に抽出したく、ジョブ管理のオーバーヘッドなしで同期的に結果を得たい場合に最適。
詳細については、JSONモードのドキュメントを参照してください。
選択ガイド
- いいえ →
/agentを使用 (自律的なWeb検索) - はい
- 単一ページ? →
/scrapeをJSONモードで使用 - 複数ページ? →
/agentをURLと共に使用 (または/scrapeのバッチ処理)
- 単一ページ? →
シナリオ別の推奨エンドポイント
料金
例: 「Find the founders of Firecrawl」
トレードオフ:
/scrape は最も低コストだが、URLを事前に把握している必要がある。/agent はコストが高いものの、対象の発見を自動で行ってくれる。
詳細な料金については、Firecrawl Pricing を参照してください。
移行: /extract → /agent
/extract を使用している場合、移行は容易です:
移行前 (extract) :
/agent を使えば URL をまったく指定せずに、必要なことを言葉で伝えるだけでよい点です。
重要なポイント
-
正確なURLがわかっている場合は?
/scrapeをJSONモードで使用してください — 最も安価 (5クレジット/ページ) 、最速 (同期処理) 、かつ最も予測しやすいオプションです。 -
自律的なリサーチが必要ですか?
/agentを使用してください — 自動で探索を行い、1日5回まで無料で利用でき、その後は複雑さに応じた動的な料金体系になります。 -
新しいプロジェクトでは
/extractから/agentへ移行 してください —/agentは、より高機能な後継エンドポイントです。 -
コストと利便性のトレードオフ: URLが分かっている場合は
/scrapeが最もコスト効率に優れています。一方で/agentはコストが高くなりますが、URLの手動探索が不要になります。

