Skip to main content
Firecrawl MCP は、ウェブコンテンツの検索、抽出、操作、監視を行うためのツールを提供します。MCP クライアントは接続時に、利用可能な各ツールの正確な入力スキーマを受け取ります。

​
ツールの利用可否

まずは Agent MCPまたはHuman MCPで、OAuth、API キー、またはキーなしアクセスを選択してください。一部の任意ツールは、環境やチームポリシーによって無効にされる場合があります。

​
ツールを選択

現在の引数については、MCP クライアントに表示される スキーマ を使用してください。以下の機能ガイドでは、スキーマ をここで重複して記載せず、Firecrawl の基本的な動作を説明します。

​
重要な動作

セルフホスト型 Firecrawl API に接続されたローカル MCP Server は、filePath を直接読み取れます。ホスト型サーバーはローカルマシン上のファイルを読み取れないため、2 段階の呼び出しで受け渡しを行います。
  1. filePath を指定して firecrawl_parse を呼び出し、アップロードコマンドと uploadRef を取得します。
  2. ファイルを読み取れるマシンでアップロードコマンドを実行します。
  3. 返された uploadRef を指定して、再度 firecrawl_parse を呼び出します。
アップロードコマンドでは短時間のみ有効な署名付きターゲットを使用し、Firecrawl APIキーは含まれません。公開ドキュメントの URL には firecrawl_scrape を使用してください。
firecrawl_crawl と firecrawl_agent はジョブ ID を返します。ジョブが完了または失敗するまで、firecrawl_check_crawl_status または firecrawl_agent_status を使用してください。
url を指定して開始するか、以前の スクレイピング 呼び出しで取得した scrapeId を再利用します。ワークフローが完了したら、scrapeId を指定して firecrawl_interact_stop を呼び出し、セッションを解放します。
firecrawl_monitor_* ファミリーでは、定期的に実行されるモニターの作成、一覧表示、更新、実行、確認を行えます。firecrawl_monitor_delete はモニターを完全に削除するため、ユーザーが明示的に削除を意図している場合にのみ呼び出してください。
firecrawl_search_feedback を登録しない場合は、FIRECRAWL_NO_SEARCH_FEEDBACK=1 を設定します。firecrawl_feedback を登録しない場合は、FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 を設定します。

​
機能ガイド

スクレイピング

1つのURLからコンテンツまたは構造化フィールドを抽出します。

検索

関連するWeb、ニュース、画像、開発者向けのソースを検索します。

クロール

サイトまたはセクションをクロールして抽出します。

解析

ファイルをLLM対応の出力に変換します。

Interact

ライブブラウザセッションで動的なページを操作します。

Agent

複数のソースを対象とした自律型リサーチを実行します。

モニタリング

ページの変更を追跡し、通知を受け取ります。

​
トラブルシューティング

  • ツールが表示されない: Agent MCPまたはHuman MCPの接続モードを確認し、クライアントを再接続または再起動して、チームポリシーによって任意のツールが無効化されていないか確認してください。
  • クライアントが401を返す: OAuthで再度サインインするか、設定したベアラートークン用の環境変数に有効なFirecrawl APIキーが含まれていることを確認してください。
  • クライアントがレート制限に達している: 現在のレート制限を確認し、再試行間隔が過ぎるまで待つか、キーなしアクセスから認証済みアクセスに切り替えてください。