Firecrawlの/agentでできること
/agentはFirecrawl APIのエンドポイント(POST https://api.firecrawl.dev/v2/agent)で、Firecrawlはこれを「データのためのディープリサーチ」と説明しています。必要な内容(例:創業者とWebサイト付きの企業リスト)を記述したprompt(最大10,000文字)を送信すると、エージェントはWebを検索し、サイトを移動し、JavaScriptページ、ページネーション、無限スクロールに対応して、JSONを返します。型付きの出力を得るためにJSONスキーマ(PythonではPydantic、NodeではZod)を渡せるほか、実行の対象を絞るためにurlsのリストを任意で指定できます。strictConstrainToURLsを使うと、それらのページのみに限定されます。Firecrawlによると、/agentは従来の/extractエンドポイントに代わるもので、/extractは非推奨となる予定です。また、既知の単一URLには、/scrapeのJSONモードの方が低コストだとしています。
すべての実行で、FirecrawlのSpark 2モデルを使用するようになりました(従来のSpark 1 MiniおよびProという名称も引き続き使えますが、Spark 2にルーティングされます)。effort設定としてlow、medium、highを任意で指定できます。ジョブは非同期で実行されます。ジョブIDでポーリングするか、Webhookを受信します。結果はAPIを通じて24時間利用でき、スレッドIDを使うと、実行を継続するフォローアップのプロンプトを送信できます。そのほかのオプションとして、実行全体に適用するプロキシのcountry、SafeSearchフィルタリング、Zero Data Retention(2倍で課金)、承認ステップ付きで有料のAlexandriaデータプロバイダーを利用する機能があります。firecrawl.dev/agentのプレイグラウンドでコードなしで試せるほか、PythonおよびNodeのSDK、CLI、FirecrawlのMCPサーバーから呼び出せます。Parallel Agentsは、数百から数千件の/agentクエリを、スプレッドシート形式のグリッドとしてバッチ処理します。
