Skip to main content

利用可能なツール

1. Scrape ツール (firecrawl_scrape)

高度なオプションを使用して、1 つの URL からコンテンツをスクレイピングします。
個人を特定できる情報をマスキングするには、スクレイピングツールの引数にredactPIIを含めます。

2. Map ツール (firecrawl_map)

Web サイトをマッピングし、サイト内のインデックス済み URL をすべて検出します。

Map Tool のオプション:

  • url: マッピング対象の Web サイトのベース URL
  • search: URL を絞り込むための任意の検索語
  • sitemap: サイトマップの使用方法を指定 - “include”、“skip”、または “only”
  • includeSubdomains: マッピングにサブドメインを含めるかどうか
  • limit: 返す URL の最大数
  • ignoreQueryParameters: マッピング時にクエリパラメータを無視するかどうか
最適な用途: スクレイピング対象を決める前に Web サイト内の URL を見つける、または Web サイト内の特定セクションを探す。 戻り値: サイト内で見つかった URL の配列。 ウェブを検索し、必要に応じて検索結果からコンテンツを抽出します。

Search Tool のオプション:

  • query: 検索クエリ文字列 (必須)
  • limit: 返す検索結果の最大数
  • location: 検索結果の地理的ロケーション
  • tbs: 期間ベースの検索フィルター (例: 過去1日は qdr:d、過去1週間は qdr:w、過去1か月は qdr:m)
  • filter: 追加の検索フィルター
  • sources: 検索対象のソースタイプの配列 (webimagesnews)
  • scrapeOptions: 検索結果ページのスクレイピングオプション
  • enterprise: エンタープライズオプションの配列 (defaultanonzdr)

4. Parse Tool (firecrawl_parse)

PDF、DOCX、XLSX、HTML ドキュメントなどのローカルファイルを、クリーンで LLM 対応のデータに解析します。
FIRECRAWL_API_URL を使用して Firecrawl API インスタンスに対し Firecrawl MCP をローカルで実行する場合、MCP Server は filePath を直接読み取り、ファイルのバイト列を /v2/parse に送信できます。 リモートのホスト型 MCP Server を使用する場合、ホスト型サーバーはお使いのマシン上のファイルを読み取れません。その場合、firecrawl_parse はリモートのキーなし URL でも機能する、2 段階の受け渡しを使用します。
  1. filePath を指定して firecrawl_parse を呼び出します。ツールは、あらかじめ入力されたアップロードコマンドと、uploadRef を含む nextToolCall を返します。
  2. ファイルを読み取れるマシンでアップロードコマンドを実行し、返された uploadRef を指定して再度 firecrawl_parse を呼び出します。
アップロードコマンドは、短時間のみ有効な署名付きアップロード先にファイルのバイト列を送信します。Firecrawl APIキーは含まれません。

Parse Tool のオプション:

  • filePath: 解析するファイルのローカルパスです。最初の呼び出しで使用します。
  • uploadRef: 最初のホスト型 MCP 呼び出しで返される参照です。アップロード成功後の 2 回目の呼び出しで使用します。
  • formats: 出力フォーマットです。デフォルトは markdown です。
  • parsers: PDF 解析オプションなど、パーサーを制御します。
  • contentType: 任意で指定できるファイルの MIME タイプのオーバーライドです。
  • declaredSizeBytes: 任意のファイルサイズの目安です。ファイルサイズは 50 MB までです。
最適な用途: 公開 URL から利用できないローカルまたは非公開のドキュメント。 推奨されない用途: 公開ドキュメントの URL。代わりに firecrawl_scrape を使用してください。URL 上のドキュメントを検出して解析します。

5. クロールツール (firecrawl_crawl)

高度なオプションを指定して、非同期クロールを開始します。

6. クロールのステータスを確認 (firecrawl_check_crawl_status)

クロールジョブのステータスを確認します。
戻り値: クロールジョブのステータスと進行状況。利用可能な場合は結果も含まれます。

7. Extract Tool (firecrawl_extract)

LLMを活用してWebページから構造化情報を抽出します。クラウドAIとセルフホスト型LLMの両方による抽出に対応しています。
レスポンスの例:

Extract Tool のオプション:

  • urls: 情報を抽出する URL の配列
  • prompt: LLM による抽出用のカスタムプロンプト
  • schema: 構造化データ抽出用の JSON スキーマ
  • allowExternalLinks: 外部リンクからの抽出を許可
  • enableWebSearch: 追加のコンテキストを得るためにウェブ検索を有効化
  • includeSubdomains: 抽出対象にサブドメインを含める
セルフホスト型インスタンスを使用する場合、設定済みの LLM が抽出に使用されます。クラウド API では、Firecrawl が管理する LLM サービスが使用されます。

8. エージェント Tool (firecrawl_agent)

クエリに基づいてインターネットを自律的にブラウジングし、情報を検索してページを移動し、構造化データを抽出するWebリサーチエージェントです。非同期で実行され、すぐにジョブIDが返されます。完了後に結果を取得するには、firecrawl_agent_statusをポーリングします。
エージェントに重点的に処理させる特定のURLを指定することもできます:

エージェント Tool のオプション:

  • prompt: 必要なデータを自然言語で記述します (必須、最大10,000文字)
  • urls: エージェント が特定のページに集中できるようにする任意の URL 配列
  • schema: 構造化された出力のための任意の JSON schema
最適な用途: 正確な URL が不明な複雑なリサーチタスク、複数のソースからのデータ収集、Web 上に散在する情報の検索、通常のスクレイピングでは失敗する JavaScript を多用した SPA からのデータ抽出。 戻り値: ステータス確認用の job ID。結果をポーリングするには firecrawl_agent_status を使用します。

9. エージェント Status の確認 (firecrawl_agent_status)

エージェント job の status を確認し、完了したら結果を取得します。15~30 秒ごとにポーリングし、request が失敗したと判断する前に、少なくとも 2~3 分間はポーリングを続けてください。

エージェント Status のオプション:

  • id: firecrawl_agent が返す エージェント job ID (必須)
ステータス:
  • processing: エージェント はまだリサーチ中です — ポーリングを続けてください
  • completed: リサーチが完了しました — レスポンスに抽出データが含まれます
  • failed: エラーが発生しました
戻り値: エージェント job のステータス、進捗状況、結果 (完了している場合) 。

10. ページを操作する (firecrawl_interact)

ライブのブラウザセッションでページを操作します。ボタンのクリック、フォームへの入力、動的コンテンツの抽出、より深いページへの移動などが可能です。 ターゲットの指定方法は2つあります。
  • url を渡すと、1回のMCP呼び出しで新しいページを開いて操作できます。
  • 以前の firecrawl_scrape 呼び出しで取得した scrapeId を渡すと、すでに読み込まれているページを再利用できます。
urlscrapeId を同時に渡さないでください。prompt または code のいずれかを指定してください。scrapeOptionsurl モードでのみ使用できます。 URLモードの例:
スクレイピングの再利用の例:

Interact ツールのオプション:

  • url: 操作するページ。セッションを開きます。これまたは scrapeId を使用します。
  • scrapeId: 以前の firecrawl_scrape 呼び出しで取得したスクレイピングジョブ ID。これまたは url を使用します。
  • prompt: 実行する操作を説明する自然言語の指示。prompt または code を指定します。
  • code: ブラウザセッションで実行するコード。code または prompt を指定します。
  • language: bashpython、または node (任意。デフォルトは nodecode でのみ使用) 。
  • timeout: 実行タイムアウト (秒単位) 。1~300 (任意。デフォルトは30) 。
  • scrapeOptions: url モードでのみ使用する任意のスクレイピング制御。
最適な用途: 単一ページ上で複数ステップのワークフローを実行する場合 — サイト内検索、検索結果のクリック、フォーム入力、操作が必要なデータの抽出。 戻り値: 出力とライブビュー URL を含む操作結果。

11. Interact セッションを停止 (firecrawl_interact_stop)

スクレイピングしたページの Interact セッションを停止します。操作が完了したら、リソースを解放するためにこのツールを呼び出してください。

Interact 停止オプション:

  • scrapeId: 停止するセッションのスクレイピング ID (必須)
戻り値: セッションが停止したことの確認。

ロギングシステム

サーバーには、包括的なログ機能が含まれています。
  • オペレーションのステータスと進行状況
  • パフォーマンス指標
  • クレジット使用量の監視
  • レート制限の追跡
  • エラー状態
ログメッセージの例:

エラーハンドリング

サーバーは堅牢なエラーハンドリング機能を提供します。
  • 一時的なエラーの自動再試行
  • バックオフによるレート制限への対応
  • 詳細なエラーメッセージ
  • クレジット使用量に関する警告
  • ネットワーク障害への耐性
エラーレスポンスの例: