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

​
ツールの利用可否

まずは Get Startedを確認し、For AgentsまたはFor Humansを選択してください。一部の任意ツールは、環境やチームポリシーによって無効にされる場合があります。

​
ツールを選択

以前の Extract MCP ツールは非推奨であり、現在のツール群には含まれていません。既知のページには JSON 形式の スクレイピング を使用し、Firecrawl がソースを発見する必要がある場合は Agent を使用してください。完全な比較については、データ抽出ツールの選択を参照してください。
現在の引数については、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 は通常、クロールを開始し、終端状態になるまでポーリングしてから戻ります。この待機がタイムアウトした場合は、クロール ID を指定して firecrawl_check_crawl_status でジョブを再開します。現在の MCP 呼び出しの外部で作成されたクロールにも、同じステータスツールを使用してください。firecrawl_agent は非同期です。ジョブ ID を返し、firecrawl_agent_status でそのジョブが完了または失敗するまで確認します。
url を指定して開始するか、以前の スクレイピング 呼び出しで取得した scrapeId を再利用します。ワークフローが完了したら、scrapeId を指定して firecrawl_interact_stop を呼び出し、セッションを解放します。
firecrawl_monitor_* ファミリーでは、定期的に実行されるモニターの作成、一覧表示、更新、実行、確認を行えます。firecrawl_monitor_delete はモニターを完全に削除するため、ユーザーが明示的に削除を意図している場合にのみ呼び出してください。
Alexandria のツールを使うには認証済みセッションが必要です。キーなしセッションでは Alexandria のツールを利用できません。
  1. ディスカバリー。 認証済みの firecrawl_search はデフォルトで sources: ["web", "alexandria"] を使用し、一致したツールを data.tools に返します。ツールのみを取得する場合は sources: ["alexandria"] を、セマンティックなツール検出を省く場合は sources: ["web"] を使用します。
  2. 確認。 引数なしで firecrawl_find_tools を呼び出すと、カテゴリ、プロバイダー、ツールの順に閲覧できます。タスクや Web サイトに合ったツールを探すには query または urls を、ツールの完全なコントラクトを確認するには capabilities を使用します。次のステップは、返された nextTool に従ってください。
  3. 実行。 url の代わりに alexandria: {provider, capability, options} を指定して firecrawl_scrape を呼び出します。最大 10 件の呼び出しを配列で送信すると、まとめて実行できます。data.alexandria の各結果には data または error が含まれます。
ディスカバリーは無料です。実行ごとに、各ツールに記載された料金がかかります。プロバイダーが利用規約への同意を必要とする場合、ツールは THIRD_PARTY_DATA_TERMS_REQUIRED と requiresAction.url を返します。この URL を組織の管理者に共有し、管理者が Firecrawl ダッシュボードで規約に同意します。Agent 自身が規約に同意してはいけません。管理者による同意が確認できたら、同じ呼び出しを再送信してください。
firecrawl_search_feedback を登録しない場合は、FIRECRAWL_NO_SEARCH_FEEDBACK=1 を設定します。firecrawl_feedback を登録しない場合は、FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 を設定します。

​
機能ガイド

スクレイピング

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

検索

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

Research Index

論文を検索し、本文箇所を読み、引用をたどります。

Developer Index

issue、PR、README、ドキュメントからコーディングに関する質問に回答します。

クロール

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

解析

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

Interact

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

Agent

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

モニタリング

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

Alexandria

サードパーティのプロバイダーが提供するデータツールを検索して実行します。

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

  • ツールが表示されない: Get Startedの接続モードを確認し、クライアントを再接続または再起動して、チームポリシーによって任意のツールが無効化されていないか確認してください。
  • クライアントが401を返す: まず設定したサーバーURLを確認してください。
    • 設定したURLが/v2/mcp-oauthの場合は、クライアントから再度サインインしてください。
    • /v2/mcpの場合は、そのサーバーのAPIキーを置き換えるか、既存のサーバーURLを/v2/mcp-oauthに更新してサインインを完了してください。
    • いずれかの変更後に、新しいクライアントセッションを開始してください。
  • クライアントがレート制限に達している: 現在のレート制限を確認し、再試行間隔が過ぎるまで待つか、キーなしアクセスから認証済みアクセスに切り替えてください。