DEV Community

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

Posted on Originally published at apidog.com

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

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

今すぐApidogを試す

以下では、ローカルマシンで動作するもの、クラウドに送信されるもの、インストール方法、提供される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
Enter fullscreen mode Exit fullscreen mode

--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 Cloudが取得します。アカウントは不要です。
  • Alexandriaデータプロバイダー。 これらはFirecrawl Cloud上で動作し、無料アカウントが必要です。詳細はFirecrawl Alexandria解説記事をご覧ください。

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
Enter fullscreen mode Exit fullscreen mode

代わりに最新コードからビルドする場合は、リポジトリをクローンして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"]}'
Enter fullscreen mode Exit fullscreen mode

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

ルート 動作
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には足りない機能が記載されています。

  • ローカルではjsonやsummary形式が使えません。 モデルが必要なため、ローカルスクレイプでは警告付きでスキップされます。
  • ブラウザのactionsが使えません。 クリック、スクロール、入力の各ステップは無視されます。
  • スクリーンショットにはChromeが必要です。
  • ジョブはメモリ上に存在します。 クロールとバッチジョブは開始から1時間で期限切れとなり、serveを停止すると失われます。
  • v0およびv1 APIルートは提供されません。

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

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

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

  • scrape、crawl、map、mcpはキーボードの前にいる人のために動作するため、localhostやプライベートネットワークにアクセスできます。scrape、crawl、mcpは--public-onlyを受け付け、これらのアドレスを拒否できます。
  • serveは127.0.0.1にバインドし、--allow-privateを渡さない限りlocalhostやプライベートターゲットを拒否します。--hostで別のアドレスにバインドするには--tokenが必要です。
  • リンクローカルアドレスとクラウドメタデータアドレスは常にブロックされます。 リダイレクトやDNS解決後も同様です。

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

Firecrawl Localの対象ユーザー

  • スクレイパーやRAGパイプラインを開発する開発者で、クラウドのボリューム課金前に無料で高速に試行錯誤したい方。
  • コーディングエージェントのユーザーで、すべてのページを第三者経由せずにClaude Code、Cursor、Codex内でWeb読取を行いたい方。
  • データに関するルールがあるチームで、FIRECRAWL_CLOUD=offを使い、取得内容をマシン上に留めたい方。

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
Enter fullscreen mode Exit fullscreen mode

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

バックグラウンドで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を返すことを検証するテストケースを追加して。
その後テストを実行し、失敗があれば要約して。
Enter fullscreen mode Exit fullscreen mode

コーディングエージェントのワークフロー:エージェントが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
Enter fullscreen mode Exit fullscreen mode

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形式、ブラウザアクション、永続ジョブを省いています。

Top comments (0)