Firecrawlのセルフホスト版とローカル版の違い:何が変わったのか

セルフホスト版のFirecrawlは、Docker Compose上で5つのサービスを実行します。Firecrawl Localは、localhost:3002で同じv2 APIを提供する単一のRustバイナリです。それぞれが何をカバーするのか、37倍という主張が何を意味するのか、そしてどちらを選ぶべきかを説明します。

INEZA Felin-Michel

INEZA Felin-Michel

19 11月 2026

Firecrawlのセルフホスト版とローカル版の違い:何が変わったのか

Apidog エンタープライズ

オンプレミスデプロイ

SSO & RBAC

SOC 2 準拠

Apidog Enterpriseを見る

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までに制限しており、ガイドはこれらの制限が「検証済みの最低要件ではない」と注記しています。

Side-by-side architecture: self-hosted Firecrawl runs api with workers, playwright-service, redis, rabbitmq and nuq-postgres under docker compose up, while Firecrawl Local is one Rust binary with optional Chrome and a dotted hand-off to Firecrawl Cloud for search, blocked pages and Alexandria; both expose the v2 API on localhost:3002

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はあなたのマシン上で次のルートを提供します:

その他のすべての/v2ルート、たとえば/v2/searchは、FIRECRAWL_CLOUDが別途指定しない限りFirecrawl Cloudにパススルーされます。v0とv1のルートは一切提供されません。

セルフホストFirecrawlは、オープンソースとクラウドの比較ページによれば、デフォルトスタックでコアなscrape、crawl、map、searchをカバーします。LLMベースの抽出には、接続するプロバイダーが必要です。Agent、Browser、Interact、ダッシュボードは含まれません。

実用上の注意点が2つあります:

  1. ヘルスチェックが異なります。セルフホストガイドは/v0/health/readinessで準備状態をチェックします。Firecrawl Localはv0を提供しないため、代わりにGET /healthを使ってください。モニターやcomposeのヘルスチェックを更新しましょう。
  2. 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は、単一マシン向けにより厳しいデフォルトで提供されます:

その代償がクラウドへの引き渡しです。デフォルトのFIRECRAWL_CLOUD=autoでは、search、あなたのマシンをブロックするページ、AlexandriaはFirecrawl Cloudに送られます。それらの結果には"source": "firecrawl-cloud"が付きます。searchのみを許可するにはFIRECRAWL_CLOUD=search、何も送らないようにするにはoffを設定してください。

Alexandriaは、Firecrawlのデータプロバイダーのカタログで、無料アカウントとfirecrawl-local loginが必要です。Firecrawl Alexandria解説記事では、それが返すものについて説明しています。

どちらを選ぶべきか?

Firecrawl Localを選ぶべきケース:

セルフホストFirecrawlを維持すべきケース:

多くのチームは両方を併用するでしょう。ノート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.
Parity test: a coding agent runs the same Apidog test case against the self-hosted stack on port 3002 and Firecrawl Local on port 3012, then diffs the two reports on status, success and markdown

エージェントはペイロードスキーマを読み、検証し、同じケースを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はエージェントがあなたのプライベートネットワークに到達するのを防ぎます。

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる