ツールの利用可否
まずは MCP setupで、キーなし、OAuth、または API キーによるアクセスを選択してください。一部の任意ツールは、環境やチームポリシーによって無効にされる場合があります。
ツールを選択
以前の Extract MCP ツールは非推奨であり、現在のツール群には含まれていません。既知のページには JSON 形式の スクレイピング を使用し、Firecrawl がソースを発見する必要がある場合は Agent を使用してください。完全な比較については、データ抽出ツールの選択を参照してください。
重要な動作
ローカルファイルを解析する
ローカルファイルを解析する
セルフホスト型 Firecrawl API に接続されたローカル MCP Server は、
filePath を直接読み取れます。ホスト型サーバーはローカルマシン上のファイルを読み取れないため、2 段階の呼び出しで受け渡しを行います。filePathを指定してfirecrawl_parseを呼び出し、アップロードコマンドとuploadRefを取得します。- ファイルを読み取れるマシンでアップロードコマンドを実行します。
- 返された
uploadRefを指定して、再度firecrawl_parseを呼び出します。
firecrawl_scrape を使用してください。実行中のクロールを確認する
実行中のクロールを確認する
firecrawl_crawl は通常、クロールを開始し、終了状態になるまでポーリングしてから戻ります。この待機がタイムアウトした場合は、クロール ID を指定して firecrawl_check_crawl_status でジョブを再開します。現在の MCP 呼び出しの外部で作成されたクロールにも、同じステータスツールを使用してください。firecrawl_agent は非同期です。ジョブ ID を返し、firecrawl_agent_status でそのジョブが完了または失敗するまで確認します。Interact セッションを終了する
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
複数のソースを対象とした自律型リサーチを実行します。
モニタリング
ページの変更を追跡し、通知を受け取ります。
トラブルシューティング
- ツールが表示されない: MCP setupの接続モードを確認し、クライアントを再接続または再起動して、チームポリシーによって任意のツールが無効化されていないか確認してください。
- クライアントが
401を返す: まず設定したサーバーURLを確認してください。- 設定したURLが
/v2/mcp-oauthの場合は、クライアントから再度サインインしてください。 /v2/mcpの場合は、そのサーバーのAPIキーを置き換えるか、既存のサーバーURLを/v2/mcp-oauthに更新してサインインを完了してください。- いずれかの変更後に、新しいクライアントセッションを開始してください。
- 設定したURLが
- クライアントがレート制限に達している: 現在のレート制限を確認し、再試行間隔が過ぎるまで待つか、キーなしアクセスから認証済みアクセスに切り替えてください。