Firecrawl Local vs セルフホストFirecrawl:単一バイナリとDockerスタックの徹底比較
Firecrawlのセルフホストは、かつては一つの意味しかありませんでした。リポジトリをクローンし、Docker Composeを実行して、API、Playwrightサービス、Redis、RabbitMQ、Postgresをあなたのマシン上で動かし続ける、というものです。2026年11月18日、Firecrawlは第二の選択肢をリリースしました。Firecrawl Localは単一のRustバイナリで、サイトをスクレイプ、クロール、マップしてMarkdownに変換し、localhost:3002で同じv2 APIに応答します。データベースもキューもコンテナも不要です。
結論から言うと:ノートPCやエージェントのツールベルトの中で、インフラを一切使わずにscrape、crawl、map、batch scrapeを行いたいならFirecrawl Localを選びましょう。永続的なジョブ、jsonやsummaryフォーマット、自前のモデルを使ったLLM抽出、あるいはFirecrawl Cloudに一切触れないsearchルートが必要なら、セルフホストのDockerスタックを維持しましょう。
Firecrawlのセルフホストとは何か、Firecrawl Localとは何か
セルフホストのFirecrawlは、apps/apiにあるフルのFirecrawlサーバーを、Docker Composeを使って自前のインフラ上で動かすものです。Firecrawl Localはapps/localにある別の、より軽量なビルドです。単一のバイナリで、同じHTMLクレンジングコードを使ってあなたのマシン上でページを取得・クレンジングし、search、ブロックされたページ、AlexandriaはFirecrawl Cloudに任せます。
どちらもFirecrawl GitHubリポジトリに存在し、どちらもポート3002でv2 APIを提供し、どちらもAGPL-3.0の下でオープンソースです。Firecrawl Localはサーバーを置き換えるものではありません。Firecrawl LocalのREADMEにははっきりとそう書かれています。セルフホストのガイドは「apps/apiにあり、Firecrawl Localによって変更されていない」と。
Firecrawlが初めての方は、Firecrawlウェブスクレイピングガイドから始めてください。
Firecrawl LocalとセルフホストFirecrawlの概要比較
以下が簡潔な比較です。セルフホストガイド、オープンソースとクラウドの比較ページ、そしてLocalのREADMEを2026年11月19日に読んだ内容をもとにまとめています。
| セルフホストFirecrawl | Firecrawl Local | |
|---|---|---|
| 実行するもの | Docker Composeスタック:api、playwright-service、redis、rabbitmq、nuq-postgres | 単一バイナリ、firecrawl-local |
| インストール | git clone、.envを作成、docker compose up --build -d | cargo install firecrawl-local |
| 前提条件 | Git、Docker Engine、Compose v2 | RustとCコンパイラ。ChromeとNode 22+はオプション |
| API | ポート3002でv2 | ポート3002でv2(scrape、map、crawl、batch scrape、health) |
| searchルート | デフォルトスタックに含まれる | Firecrawl Cloudに転送される |
LLMフォーマット(json、summary) | OpenAI互換プロバイダーかOllamaを接続する | 警告付きでスキップされる |
| スクリーンショット | Fire-engineが必要で、デフォルトスタックには含まれない | Chromeがインストールされていれば動作する |
ブラウザactions | Fire-engineが必要 | 無視される |
| ジョブの保存 | Postgresベースのキュー | メモリ内、1時間で失効 |
| Alexandria | セルフホスト機能表に記載なし | 無料アカウントでFirecrawl Cloud経由 |
| MCPのセットアップ | MCPサーバーをあなたのURLに向ける | firecrawl-local initが設定を書き込む |
| ライセンス | AGPL-3.0 | AGPL-3.0 |
Localは深さと引き換えに軽さを手に入れています。エージェントが最も頻繁に呼ぶルートは残し、キュー、モデル、ブラウザファームを必要とするものは削ぎ落としています。
何が変わったか:5つのサービスから1つのバイナリへ
セルフホストの道筋では、ガイドでリリースv2.11.162が固定されています。リポジトリをクローンし、Postgresの認証情報とUSE_DB_AUTHENTICATION=falseを書いた小さな.envを作成し、スタックをビルドして起動します:
git clone https://github.com/firecrawl/firecrawl.git cd firecrawl git checkout v2.11.162 docker compose up --build -d docker compose ps --all このcomposeファイルは、apiコンテナ(ワーカーも実行します)、レンダリング用のplaywright-service、ジョブキューのためのredis、rabbitmq、nuq-postgresを起動します。composeファイルはAPIをCPU 4コア、メモリ8GBまで、PlaywrightサービスをCPU 2コア、メモリ4GBまでに制限しており、ガイドはこれらの制限が「検証済みの最低要件ではない」と注記しています。
Firecrawl Localはそれを1つのコマンドに集約します:
cargo install firecrawl-local firecrawl-local scrape https://example.com --markdown firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages firecrawl-local map https://firecrawl.dev firecrawl-local serve .envもコンテナもありません。JavaScriptページは既にお持ちのChromeまたはChromiumでレンダリングされます。それらがなければ静的ページは動作しますが、それ以外は警告を返します。
search、find-tools、data、loginコマンドはFirecrawl Cloudに到達します。firecrawl-local loginは、Firecrawl CLIインストールガイドで紹介しているホスト版CLIの認証情報を再利用します。
エンドポイントの対応範囲:それぞれが何を提供するか
ここがマイグレーションで壊れる箇所なので、SDKのベースURLを切り替える前に確認してください。
Firecrawl Localはあなたのマシン上で次のルートを提供します:
-
POST /v2/scrapeは1つのURLをスクレイプする -
POST /v2/mapはサイトのURLを一覧する -
POST /v2/crawl、およびGETとDELETE /v2/crawl/{id} -
POST /v2/batch/scrape、およびGETとDELETE /v2/batch/scrape/{id} GET /health
その他のすべての/v2ルート、たとえば/v2/searchは、FIRECRAWL_CLOUDが別途指定しない限りFirecrawl Cloudにパススルーされます。v0とv1のルートは一切提供されません。
セルフホストFirecrawlは、オープンソースとクラウドの比較ページによれば、デフォルトスタックでコアなscrape、crawl、map、searchをカバーします。LLMベースの抽出には、接続するプロバイダーが必要です。Agent、Browser、Interact、ダッシュボードは含まれません。
実用上の注意点が2つあります:
- ヘルスチェックが異なります。セルフホストガイドは
/v0/health/readinessで準備状態をチェックします。Firecrawl Localはv0を提供しないため、代わりにGET /healthを使ってください。モニターやcomposeのヘルスチェックを更新しましょう。 - searchの実行場所が変わります。Dockerスタックでは、searchはあなたのインフラ上に留まります。LocalではFirecrawl Cloudに送信され、キーなしのsearchはレート制限されます。何もマシンの外に出てはいけない場合は
FIRECRAWL_CLOUD=offを設定してください。ただしsearchは機能しなくなります。
速度とメモリ:主張は慎重に読むこと
FirecrawlのXのローンチ投稿は、Firecrawl Localが「Rustベースの37倍高速なスクレイププリミティブ(セルフホスト比)」であり、「メモリ使用量が230分の1(アイドル時11MB)」だと述べています。この投稿は初日に約32.4万回表示され、3.2千のいいねを集めました。
これらの数値はFirecrawlの主張として扱ってください。READMEにはベンチマークの方法も、ページセットも、ハードウェアも公開されていないため、「37倍」が何を測定したのかは分かりません。アーキテクチャが裏付けるのは方向性です。アイドル状態のプロセスが1つなら、composeの制限でAPIとPlaywrightサービスのみで最大12GBを許容する5つのコンテナより、はるかに軽いはずです。
速度で選ぶなら、自分のURLで測定してください。同じスクレイプを両方のサーバーに対して実行し、タイミングを比較し、Markdownが一致するか確認しましょう。以下のApidog CLIのセクションでは、それを再現可能なテストにする一つの方法を紹介します。
セキュリティ、クラウドへの引き渡し、データフロー
セルフホストは完全な制御と完全な責任を与えます。ガイドのクイックスタートは認証を無効化しており、「本番アーキテクチャではない」と警告しています。永続ボリューム、認証、TLS、モニタリングは自分で追加する必要があります。
Firecrawl Localは、単一マシン向けにより厳しいデフォルトで提供されます:
-
serveは127.0.0.1にバインドし、--allow-privateを渡さない限りlocalhostとプライベートアドレスを拒否します。 - リンクローカルアドレスとクラウドのメタデータアドレスは、リダイレクト後も含め、すべてのモードでブロックされます。
-
scrape、crawl、mcpは--public-onlyを受け付けます。READMEは、エージェントが信頼できないサイトを閲覧する場合にこれを推奨しています。 - クロールは
robots.txtを尊重します。
その代償がクラウドへの引き渡しです。デフォルトのFIRECRAWL_CLOUD=autoでは、search、あなたのマシンをブロックするページ、AlexandriaはFirecrawl Cloudに送られます。それらの結果には"source": "firecrawl-cloud"が付きます。searchのみを許可するにはFIRECRAWL_CLOUD=search、何も送らないようにするにはoffを設定してください。
Alexandriaは、Firecrawlのデータプロバイダーのカタログで、無料アカウントとfirecrawl-local loginが必要です。Firecrawl Alexandria解説記事では、それが返すものについて説明しています。
どちらを選ぶべきか?
Firecrawl Localを選ぶべきケース:
- AIエージェントにノートPC上でスクレイプとクロールをさせたい。
firecrawl-local initはMCPサーバーをClaude Code、Claude Desktop、Cursor、Windsurf、Gemini CLI、Codexに追加し、各設定を事前にバックアップします。 - 1時間以内に完了する短時間のジョブを実行する。
- 必要なのはMarkdown、HTML、生のHTML、リンクだけ。
- Postgres、Redis、RabbitMQを自分で管理したくない。
セルフホストFirecrawlを維持すべきケース:
- クロールジョブが再起動を乗り越える必要がある、または1時間以上実行する必要がある。
- 自前のモデルを使って
jsonやsummaryの出力が必要。 - searchがあなたのインフラ上に留まる必要がある。
- 複数のサービスやユーザーが、あなたの認証の背後で1つのスクレイピングバックエンドを共有する。
多くのチームは両方を併用するでしょう。ノートPCやエージェントではLocal、本番ではDockerスタックかFirecrawl Cloudです。searchだけを必要とするエージェントのセットアップについては、Claude向けオープンソースウェブ検索のまとめ記事で他の選択肢を、Firecrawl MCPとllms.txtガイドでホスト版MCPサーバーを紹介しています。
SDKコードをセルフホストからLocalへ移行する
SDKコードは変わりません。変わるのはURLだけです。PythonまたはNode SDKのAPI URLをhttp://localhost:3002に設定し、ローカルルートにはAPIキーは不要です。切り替える前に、あなたのコードがv0やv1の呼び出しを行っていないこと、json、summary、actionsを要求していないこと、1時間より古いクロールIDやserveの再起動をまたいだクロールIDをポーリングしていないことを確認してください。
コーディングエージェントにApidog CLIでパリティテストを実行させる
バックエンドの切り替えは契約の問題です。Localの/v2/scrapeは、あなたのコードが既にパースしているのと同じ形を返すのか? 手作業でレスポンスをdiffしないでください。両方のサーバーを並行して起動し(Dockerは3002、firecrawl-local serve --port 3012)、コーディングエージェントにApidog CLIで両方をテストさせましょう。
一度セットアップします:
npm install -g apidog-cli@latest apidog auth login --with-token <YOUR_TOKEN> apidog skill install 次にエージェントに1つのプロンプトを与えます:
Self-hosted Firecrawl runs on http://localhost:3002 and Firecrawl Local on http://localhost:3012. In Apidog project <id>, create two environments, "self-hosted" and "local". Add test cases for POST /v2/scrape on https://example.com (assert 200, success: true, non-empty data.markdown) and POST /v2/map (assert 200 and a non-empty links array). Run the cases against both environments and tell me every assertion that differs. エージェントはペイロードスキーマを読み、検証し、同じケースを2回実行します:
firecrawl-local serve --port 3012 & apidog environment create self-hosted --project <id> --base-url http://localhost:3002 apidog environment create local --project <id> --base-url http://localhost:3012 apidog cli-schema get test-case-create apidog cli-schema validate test-case-create --file scrape-case.json apidog test-case create --project <id> --file scrape-case.json apidog run --test-case <caseId> --project <id> -e <selfHostedEnvId> -r cli,json --out-file self-hosted apidog run --test-case <caseId> --project <id> -e <localEnvId> -r cli,json --out-file local Apidog CLIはあなたのマシンからリクエストを送信するので、両方のlocalhostポートに到達できます。-r cli,jsonを-r junitに置き換えれば、FirecrawlをアップグレードするたびにCIで同じチェックを実行できます。Apidog CLI CI/CDガイドでセットアップを、Claude CodeでのApidog CLIでエージェント側を説明しています。Apidogの無料プランは最大4ユーザーのチームをカバーします。
FAQ
Firecrawl LocalはセルフホストFirecrawlを置き換えますか? いいえ。apps/localにある別のビルドです。apps/apiにあるフルサーバーとそのセルフホストガイドは変更されておらず、永続的なジョブとLLMフォーマットには引き続き必要です。
Firecrawl Localは本当にセルフホストFirecrawlより37倍高速ですか? それはFirecrawlのローンチ投稿の主張で、メモリ使用量が230分の1、アイドル時11MBというのも同じです。READMEにはベンチマーク方法が公開されていないので、自分のURLでテストしてください。
Firecrawl Localはクラウドなしで動作しますか? はい。FIRECRAWL_CLOUD=offを設定すれば、スクレイプ、クロール、マッピングはあなたのマシン上に留まります。search、ブロックされたページのフォールバック、Alexandriaは機能しなくなります。
セルフホストFirecrawlは無料ですか? コードはサーバーもLocalもAGPL-3.0の下で無料です。マシンの費用と、Postgres、Redis、RabbitMQを自分で運用する時間のコストはかかります。
AIエージェントはどちらを使うべきですか? ほとんどの場合、Firecrawl Localです。firecrawl-local initは6つのエージェントツールにMCPサーバーとして登録し、--public-onlyはエージェントがあなたのプライベートネットワークに到達するのを防ぎます。



