Firecrawl MCP は、ウェブコンテンツの検索、抽出、操作、監視を行うためのツールを提供します。MCP クライアントは接続時に、利用可能な各ツールの正確な入力スキーマを受け取ります。
ツールの利用可否#
| 接続モード | 利用可能なツール |
|---|---|
| ホスト型 OAuth | プランおよびチームポリシーに応じたすべてのツール |
| ホスト型 API キー | プランおよびチームポリシーに応じたすべてのツール |
| ホスト型キーなし | firecrawl_search、firecrawl_scrape、firecrawl_parse |
| Firecrawl cloud API を使用するローカル環境 | API ベースのツール。ローカルファイルの直接解析は利用できません |
| セルフホスト型 Firecrawl API を使用するローカル環境 | そのデプロイで有効なサービスがサポートするツール |
まずは Get Startedを確認し、For AgentsまたはFor Humansを選択してください。一部の任意ツールは、環境やチームポリシーによって無効にされる場合があります。
ツールを選択#
| ジョブ | ツール | 使用する場面 |
|---|---|---|
| 1 ページを取得する | firecrawl_scrape | URL がわかっており、ページコンテンツや構造化フィールドが必要な場合。 |
| 構造化データを抽出する | JSON 形式の firecrawl_scrape | URL があり、prompt または JSON スキーマ に一致するデータが必要な場合。 |
| サイトの 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_* | 論文を見つけたり、論文内の本文箇所を読んだり、引用をたどったりする必要がある場合。PubMed、bioRxiv、medRxiv、arXiv の論文要旨を対象とする Research Index を検索します。 |
| プログラミングに関する質問に答える | firecrawl_developer_search | issues、マージ済みのプルリクエスト、README、厳選されたドキュメントに基づく一次情報の回答が必要な場合。 |
| 変更を監視する | firecrawl_monitor_* | 定期チェック、diff、webhook または email 通知が必要な場合。 |
| プロダクトフィードバックを送信する | firecrawl_search_feedback and firecrawl_feedback | 検索結果を評価したり、エンドポイント単位の品質を報告したりする場合。 |
以前の Extract MCP ツールは非推奨であり、現在のツール群には含まれていません。既知のページには JSON 形式の スクレイピング を使用し、Firecrawl がソースを発見する必要がある場合は Agent を使用してください。完全な比較については、データ抽出ツールの選択を参照してください。
現在の引数については、MCP クライアントに表示される スキーマ を使用してください。以下の機能ガイドでは、スキーマ をここで重複して記載せず、Firecrawl の基本的な動作を説明します。
重要な動作#
ローカルファイルを解析する
セルフホスト型 Firecrawl API に接続されたローカル MCP Server は、filePath を直接読み取れます。ホスト型サーバーはローカルマシン上のファイルを読み取れないため、2 段階の呼び出しで受け渡しを行います。
filePathを指定してfirecrawl_parseを呼び出し、アップロードコマンドとuploadRefを取得します。- ファイルを読み取れるマシンでアップロードコマンドを実行します。
- 返された
uploadRefを指定して、再度firecrawl_parseを呼び出します。
アップロードコマンドでは短時間のみ有効な署名付きターゲットを使用し、Firecrawl APIキーは含まれません。公開ドキュメントの URL には firecrawl_scrape を使用してください。
実行中のクロールを確認する
firecrawl_crawl は通常、クロールを開始し、終了状態になるまでポーリングしてから戻ります。この待機がタイムアウトした場合は、クロール ID を指定して firecrawl_check_crawl_status でジョブを再開します。現在の MCP 呼び出しの外部で作成されたクロールにも、同じステータスツールを使用してください。
firecrawl_agent は非同期です。ジョブ ID を返し、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、ニュース、画像、開発者向けのソースを検索します。
論文を検索し、本文箇所を読み、引用をたどります。
issue、PR、README、ドキュメントからコーディングに関する質問に回答します。
サイトまたはセクションをクロールして抽出します。
ファイルをLLM対応の出力に変換します。
ライブブラウザセッションで動的なページを操作します。
複数のソースを対象とした自律型リサーチを実行します。
ページの変更を追跡し、通知を受け取ります。
トラブルシューティング#
- ツールが表示されない: Get Startedの接続モードを確認し、クライアントを再接続または再起動して、チームポリシーによって任意のツールが無効化されていないか確認してください。
- クライアントが
401を返す: まず設定したサーバーURLを確認してください。- 設定したURLが
/v2/mcp-oauthの場合は、クライアントから再度サインインしてください。 /v2/mcpの場合は、そのサーバーのAPIキーを置き換えるか、既存のサーバーURLを/v2/mcp-oauthに更新してサインインを完了してください。- いずれかの変更後に、新しいクライアントセッションを開始してください。
- 設定したURLが
- クライアントがレート制限に達している: 現在のレート制限を確認し、再試行間隔が過ぎるまで待つか、キーなしアクセスから認証済みアクセスに切り替えてください。