Firecrawl MCP ツール

Firecrawl MCP ツールを選択し、利用可否と動作を確認します。

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

ツールの利用可否

接続モード	利用可能なツール
ホスト型 OAuth	プランおよびチームポリシーに応じたすべてのツール
ホスト型 API キー	プランおよびチームポリシーに応じたすべてのツール
ホスト型キーなし	firecrawl_search、firecrawl_scrape、firecrawl_parse
Firecrawl cloud API を使用するローカル環境	API ベースのツール。ローカルファイルの直接解析は利用できません
セルフホスト型 Firecrawl API を使用するローカル環境	そのデプロイで有効なサービスがサポートするツール

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

ツールを選択

ジョブ	ツール	使用する場面
1 ページを取得する	firecrawl_scrape	URL がわかっており、ページコンテンツや構造化フィールドが必要な場合。
サイトの URL を見つける	firecrawl_map	抽出対象を決める前にページを探す必要がある場合。
Web を検索する	firecrawl_search	URL ではなく query がある場合。
ファイルを解析する	firecrawl_parse	PDF、ドキュメント、スプレッドシート、HTML ファイルのコンテンツが必要な場合。
複数ページを抽出する	firecrawl_crawl and firecrawl_check_crawl_status	サイトまたはセクションをクロールする必要がある場合。クロールツールは、結果を返す前にジョブが終端状態になるまでポーリングします。
自律型リサーチを実行する	firecrawl_agent and firecrawl_agent_status	タスクが複数のソースにまたがり、対象ページが特定されていない場合。
ライブページを操作する	firecrawl_interact and firecrawl_interact_stop	クリック、フォーム入力、ナビゲーション、動的ページの抽出が必要な場合。
論文とリポジトリをリサーチする	firecrawl_research_*	論文のディスカバリー、閲覧、関連研究の検索、公開リポジトリの検索が必要な場合。
プログラミングに関する質問に答える	firecrawl_developer_search	issues、マージ済みのプルリクエスト、README、厳選されたドキュメントに基づく一次情報の回答が必要な場合。
変更を監視する	firecrawl_monitor_*	定期チェック、diff、webhook または email 通知が必要な場合。
プロダクトフィードバックを送信する	firecrawl_search_feedback and firecrawl_feedback	検索結果を評価したり、エンドポイント単位の品質を報告したりする場合。

現在の引数については、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 を使用してください。

Interact セッションを終了する

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キーが含まれていることを確認してください。
• クライアントがレート制限に達している: 現在のレート制限を確認し、再試行間隔が過ぎるまで待つか、キーなしアクセスから認証済みアクセスに切り替えてください。