Firecrawl Localとは?ローカルマシンでFirecrawlを実行する方法

Firecrawl Localは、1つのRustバイナリで、自分のマシン上でWebサイトをスクレイピング、クロール、マッピングしてMarkdownに変換し、localhost:3002でFirecrawl v2 APIを提供します。ここでは、ローカルで動作する部分、クラウドに送信される部分、インストール方法、そしてその限界について説明します。

INEZA Felin-Michel

INEZA Felin-Michel

19 11月 2026

Firecrawl Localとは?ローカルマシンでFirecrawlを実行する方法

Apidog エンタープライズ

オンプレミスデプロイ

SSO & RBAC

SOC 2 準拠

Apidog Enterpriseを見る

Firecrawl Localは、Webサイトをスクレイピング、クロール、マッピングしてクリーンなMarkdownに変換する、単一のRustバイナリです。`cargo install firecrawl-local`でインストールでき、APIキー・データベース・キュー・コンテナを必要とせずに、Firecrawl v2 APIを`localhost:3002`で提供できます。検索や一部の機能は引き続きFirecrawl Cloudを利用しますが、オフにすることも可能です。

以下では、ローカルマシンで動作するもの、クラウドに送信されるもの、インストール方法、提供されるAPIルート、制限事項、そしてコーディングエージェントがApidog CLIでローカルAPIをテストする方法を説明します。

Firecrawl Localとは?

Firecrawl Localは、Firecrawlのオープンソース版オンデバイスエディションです。 Webページを取得し、ホスト版Firecrawl APIと同じHTMLクレンジングコードで整形して、Markdown・HTML・リンクを返す単一のバイナリです。CLIとして、AIエージェント向けのMCPサーバーとして、あるいはFirecrawl v2 APIのローカルコピーとして動作します。

Firecrawlは2026年11月18日、Xのローンチ投稿でこれを発表しました。コードはFirecrawlリポジトリのapps/localフォルダにあります。パッケージはcrates.ioにfirecrawl-localとして公開されており、リポジトリのライセンスはAGPL-3.0です。

Firecrawlは、セルフホスト版Firecrawlより37倍高速で、メモリ使用量は230分の1(アイドル時11 MB)だと主張しています。ただしREADMEにはベンチマーク手法が公開されていないため、これらはベンダーの主張として受け止めてください。

ホスト版APIやFirecrawl CLIをご存じなら、要はシンプルです。同じ呼び出しが、あなたのマシン上で返ってくるのです。

Firecrawl Localの仕組み:1つのバイナリ、10個のコマンド

すべての機能は`firecrawl-local`のサブコマンドとして提供されています。READMEに記載された全リストは次のとおりです。

コマンド 動作 実行場所
scrape <urls...> 1つ以上のURLをスクレイピング ローカルマシン
crawl <url> 開始URLからリンクをたどる ローカルマシン
map <url> サイトマップと開始ページからサイトのURLを一覧化 ローカルマシン
serve Firecrawl v2 APIをlocalhostで提供 ローカルマシン
mcp Firecrawl MCPサーバーをstdio経由で実行 ローカルマシン(一部ツールはクラウド)
init このマシンのAIツールにMCPサーバーを追加 ローカルマシン
search <query> Webを検索 Firecrawl Cloud
find-tools <query> Alexandriaのデータプロバイダーを検索 Firecrawl Cloud(要サインイン)
data <provider> <capability> Alexandriaのデータプロバイダーを実行 Firecrawl Cloud(要サインイン)
login ブラウザでFirecrawlにサインイン Firecrawl Cloud

日常的な用途のほとんどは次の3つのコマンドでカバーできます。

# 1ページをMarkdownで出力
firecrawl-local scrape https://example.com --markdown

# 最大50ページをクロールし、ページごとにMarkdownファイルを保存
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages

# サイト上のすべてのURLを一覧化
firecrawl-local map https://firecrawl.dev

`--markdown`を付けない場合、`scrape`はFirecrawl APIのJSONを出力します。`--format`は`markdown`、`html`、`rawHtml`、`links`を受け付けます。PDFやOffice文書もローカルでパースされます。

JavaScriptを多用するページでは、すでにインストールされているChromeまたはChromiumを操作します。Chromeがない場合でも静的ページは処理できますが、ブラウザが必要なページでは警告が返されます。Chromeをいつ使用するかは`--browser auto|never|always`で決められます。

ローカルで動くものとFirecrawl Cloudで動くもの

スクレイピング、クロール、マッピング、文書パースはローカルマシンで実行され、Firecrawlには何も送信されません。 一方、次の3つの機能はFirecrawl Cloudに送られます。ノートパソコンにはインデックスやネットワーク、データがないためです。

Firecrawl Localの役割分担:スクレイピング、クロール、マッピング、PDF/Officeパースは任意のChromeを伴ってローカルマシンで実行され、検索、ブロックされたページのフォールバック、AlexandriaデータはFIRECRAWL_CLOUD=autoでFirecrawl Cloudに送られ、searchまたはoffに切り替え可能

`FIRECRAWL_CLOUD`環境変数でこの引き渡しを制御できます。

値 効果
auto(デフォルト) 検索、ブロックされたページのフォールバック、Alexandriaがすべて動作
search 検索のみFirecrawl Cloudに送信
off Firecrawl Cloudには何も送信しない

認識できない値は`off`として扱われます。クラウドで取得された結果には`"source": "firecrawl-cloud"`が付与されます。クラウドでも失敗した場合は`"blocked": true`が返ります。

クラウド呼び出しにはランダムなインストールIDと呼び出し元ツール名が付与され、Firecrawlはこれでインストール数を集計しています。

Firecrawl Localのインストール方法

RustとCコンパイラが必要です。手順は次のとおりです。

  1. ビルドツールをインストールします。 macOSでは`xcode-select --install`を実行します。DebianやUbuntuでは`build-essential`をインストールしてください。
  2. ChromeまたはChromiumを追加(任意)。 JavaScriptレンダリングページやスクリーンショットが必要な場合に導入します。
  3. Node.js 22以降を追加(任意)。 MCPサーバーを使う場合に必要で、`npx`経由で`firecrawl-mcp` npmパッケージを実行します。
  4. サインイン(任意)。 Alexandriaプロバイダーを使う場合は`firecrawl-local login`でサインインします。

バイナリをcrates.ioからインストールします。

cargo install firecrawl-local
firecrawl-local --version

代わりに最新コードからビルドする場合は、リポジトリをクローンして`apps/local`で`cargo build --release`を実行します。

Firecrawl Local API:localhost:3002で提供されるv2ルート

`firecrawl-local serve`はポート3002でFirecrawl v2 APIを提供します。ローカルルートにはAPIキーは不要です。

firecrawl-local serve

# 別のターミナルで
curl -s http://localhost:3002/v2/scrape \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown"]}'

以下のルートはローカルマシンで動作します。

ルート 動作
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のルートは提供されません。

既存のコードは、設定を1か所変えるだけで移行できます。Firecrawl SDKのAPI URLを`http://localhost:3002`に向けるだけです。スクレイパーやRAGパイプラインのコードはそのままに、試行錯誤の間はクラウドクレジットを消費せずに済みます。スクレイピングパイプライン全般については、Firecrawl Webスクレイピングガイドをご覧ください。

AIエージェント向けMCPサーバーとして使うFirecrawl Local

`firecrawl-local init`は、検出されたすべてのAIツールにFirecrawl LocalをModel Context Protocolサーバーとして登録します。Claude Code、Claude Desktop、Cursor、Windsurf、Gemini CLI、Codexを認識し、各設定ファイルを事前にバックアップします。`--dry-run`で変更内容をプレビューでき、`--agent cursor`で特定のツールのみにセットアップできます。

エージェントには標準のFirecrawl MCPツールが提供されます。scrape、crawl、map、batch scrapeはローカルで動作し、それ以外はFirecrawl Cloudに送られます。

信頼できないサイトをエージェントが閲覧する場合は、`firecrawl-local mcp --public-only`で登録してください。そうしないと、隠し命令を含むページによってエージェントが内部ネットワーク上のURLを開かされる可能性があります。

Firecrawl Localの制限事項

Firecrawl Localは完全なFirecrawlサーバーではありません。READMEには足りない機能が記載されています。

キュー、ワーカー、すべての形式が必要な場合は、`apps/api`にあるフルサーバーが引き続き存在します。詳細はFirecrawlのセルフホスティングガイドで解説されています。

知っておくべきセキュリティのデフォルト設定

`serve`は他プログラムからのリクエストを受け付けるため、コマンドごとにデフォルト設定が異なります。

Chromeはヘッドレスかつサンドボックス化され、使い捨てプロファイルで実行されます。クロール時には、Firecrawl LocalはRobots Exclusion Protocolに従って`robots.txt`を読み取ります。サイト所有者は`FirecrawlLocal`として指定できます。

Firecrawl Localの対象ユーザー

`json`抽出、ブラウザアクション、長時間稼働のクロールジョブに依存している場合は、あまり適していません。エージェント向けの検索だけが必要な場合は、Claude向けオープンソースWeb検索のまとめをご覧ください。

コーディングエージェントにApidog CLIでローカルAPIをテストさせる

`serve`が動けば、`localhost:3002`に本物のHTTP APIができあがります。パイプラインに接続する前に、ルートがコードの期待どおりに応答するか確認しましょう。リクエストを手作業でクリックする代わりに、コーディングエージェントへApidog CLIと1つのプロンプトを渡してください。

セットアップは1回だけです。

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

次に、エージェントにこう依頼します。

バックグラウンドでfirecrawl-local serveを起動して。ローカルルート
(POST /v2/scrape、POST /v2/map、GET /health)用のOpenAPI 3ファイルを
作成し、Apidogプロジェクト<id>にインポートして。
http://localhost:3002を指す環境を作成し、/healthが200を返し、
https://example.comに対して/v2/scrapeがsuccess: trueかつ
空でないdata.markdownを返すことを検証するテストケースを追加して。
その後テストを実行し、失敗があれば要約して。
コーディングエージェントのワークフロー:エージェントがlocalhost:3002でfirecrawl-local serveを起動し、Apidog CLIがスペックをインポート、テストケースを作成してPOST /v2/scrape、POST /v2/map、GET /healthに対して実行し、cli・json・junitレポートを書き出す

エージェントはスキーマを読み、ペイロードを検証し、次のようなコマンドを実行します。

firecrawl-local serve &
apidog import --project <id> --format openapi --file ./firecrawl-local-v2.yaml
apidog environment create firecrawl-local --project <id> --base-url http://localhost:3002
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file ./case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json

Apidog CLIはローカルマシンからリクエストを送信するため、`localhost:3002`に到達できます。`-r cli,json`を`-r junit`に変えれば、同じ実行をCIに組み込めます。設定方法はApidog CLI CI/CDガイド、エージェント側の手順はClaude CodeでのApidog CLIで解説しています。Apidogの無料プランは最大4ユーザーのチームまでカバーします。

FAQ

Firecrawl Localは無料ですか? バイナリはAGPL-3.0のオープンソースで、ローカルのスクレイピング、クロール、マッピングにAPIキーは不要です。検索、ブロックされたページのフォールバック、AlexandriaはFirecrawl Cloudに送られ、Alexandriaには無料アカウントが必要です。

既存のFirecrawl SDKコードをFirecrawl Localで使えますか? はい、ローカルルートについては使えます。SDKのAPI URLに`http://localhost:3002`を設定してください。scrape、map、crawl、batch scrapeはローカルで動作します。v0およびv1ルートは提供されません。

Firecrawl Localがクラウドを呼び出さないようにするには? `FIRECRAWL_CLOUD=off`を設定してください。検索とブロックされたページのフォールバックは動作しなくなり、明示的な`login`を除いて何もマシン外に出ません。

Firecrawl Localはセルフホスト版Firecrawlとどう違うのですか? セルフホスト版Firecrawlは`apps/api`にあるフルサーバーで、キュー、ワーカー、すべての形式を備えています。Firecrawl Localはより軽量な単一バイナリで、`json`および`summary`形式、ブラウザアクション、永続ジョブを省いています。

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

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