Claude CodeとCursor(MCP)でFirecrawl Localを使う方法

Firecrawl Localの実践ガイド:バイナリをインストールし、initでClaude CodeとCursorにMCPサーバーとして登録し、Firecrawl v2 APIをlocalhost:3002で実行し、SDKの接続先をそこに設定して、クラウドをオフにする。

Ashley Innocent

Ashley Innocent

19 11月 2026

Claude CodeとCursor(MCP)でFirecrawl Localを使う方法

Apidog エンタープライズ

オンプレミスデプロイ

SSO & RBAC

SOC 2 準拠

Apidog Enterpriseを見る

Firecrawl Localを使うには、cargo install firecrawl-localでインストールし、firecrawl-local initを実行してClaude CodeとCursorにMCPサーバーとして登録したあと、両方のツールを再起動します。これでエージェントは自分のマシン上でサイトのスクレイピング、クロール、マッピングを行えるようになります。コードから使う場合は、firecrawl-local serveを実行し、任意のFirecrawl SDKの接続先をhttp://localhost:3002に設定します。

このガイドでは、Firecrawl Localの使い方をステップごとに紹介します。2026年11月19日のテスト実行(arm64 Mac上のFirecrawl Local 0.1.0)で得られた実際の出力に加え、エージェントに与えるプロンプトや、そのエージェントにApidog CLIでローカルAPIをテストさせる方法も取り上げます。

始める前に必要なもの

Firecrawl Localは、Firecrawlリポジトリにある単一のRustバイナリです。インストールする前に、以下を確認してください:

  1. RustとCコンパイラ。 Rustはrustup.rsから入手します。macOSではxcode-select --installを実行し、DebianまたはUbuntuではbuild-essentialをインストールします。
  2. Node.js 22以降(MCPサーバーを使う場合)。npx経由でfirecrawl-mcp npmパッケージを実行します。
  3. ChromeまたはChromium(任意)。 Firecrawl Localは、JavaScriptが必要なページに対して、すでにインストールされているブラウザを使用します。静的ページはブラウザなしでも動作します。
  4. Claude Code、Cursor、またはその他のMCPクライアント。 initはClaude Desktop、Windsurf、Gemini CLI、Codexにも対応しています。

Firecrawl自体が初めてなら、まずFirecrawl Webスクレイピングガイドから始めて、また戻ってきてください。

ステップ1:Firecrawl Localをインストールする

crates.ioからクレートをインストールし、バージョンを確認します:

cargo install firecrawl-local
firecrawl-local --version
# firecrawl-local 0.1.0

Cargoはソースからコンパイルします。私たちのMacではリリースビルドが6分54秒で完了し、バイナリは~/.cargo/bin/firecrawl-localに配置されました。このフォルダーがPATHに含まれていることを確認するか、フルパスを控えておいてください。手動でMCPをセットアップするときに必要になります。

ステップ2:ターミナルから最初のスクレイピングを実行する

エージェントに組み込む前に、取得が動作することを確認します:

FIRECRAWL_CLOUD=off firecrawl-local scrape https://example.com --markdown

1.2秒でページの本文がMarkdownとして出力されました。--markdownを外すと、Firecrawl APIが返すのと同じJSONが得られます。--format markdown,linksでフォーマットを指定できます。ローカルで選べるのはmarkdown、html、rawHtml、linksです。

次に、ページごとに1つのMarkdownファイルを書き出すクロールを実行します:

FIRECRAWL_CLOUD=off firecrawl-local crawl https://docs.firecrawl.dev --limit 20 --out ./pages

これはFirecrawlドキュメントの20ページを4.4秒で取得し、0005-docs.firecrawl.dev_advanced-scraping-guide.mdのような名前のファイルを保存しました。firecrawl-local crawl --helpで確認できる便利なクロールフラグは次のとおりです:

フラグ 動作
-l, --limit 最大ページ数(デフォルト100)
--max-depth リンクをたどる深さ
--include, --exclude 保持またはスキップするパスの正規表現(複数指定可能)
--entire-domain 開始パス外のリンクもたどる
-c, --concurrency 同時に取得するページ数
--ignore-robots robots.txtを無視する(デフォルトでは読み込まれます)

firecrawl-local map https://firecrawl.devは、サイトマップと開始ページから見つけたすべてのURLを1行のJSONとして返します。

ステップ3:initでFirecrawl LocalをClaude CodeとCursorに追加する

initはマシン上のAIツールを見つけ、それぞれのMCP設定にFirecrawl Localを追加します。まずプレビューします:

firecrawl-local init --dry-run

私たちのMacでは、変更対象となるすべてのツールが一覧表示されました:

Firecrawl MCP server:
  Claude Code: would be added in ~/.claude.json
  Claude desktop: would be added in ~/Library/Application Support/Claude/claude_desktop_config.json
  Cursor: would be added in ~/.cursor/mcp.json
  Gemini CLI: would be added in ~/.gemini/settings.json
  Codex: would be added in ~/.codex/config.toml

ドライランでは、Firecrawl Cloudに送信される内容も表示されます。検索クエリ、マシンからのアクセスをブロックしたページのURL、サインイン後のAlexandria呼び出し、ランダムなインストールIDとAIツール名です。ローカルで問題なく読み込めるページは送信されません。

このガイドで扱う2つのツールだけをセットアップするには、--agentを繰り返します:

firecrawl-local init --agent claude-code --agent cursor

有効な名前はclaude-code、claude-desktop、cursor、windsurf、gemini、codexです。initは書き込む前に各設定ファイルをバックアップします。その後、Claude CodeとCursorを再起動して新しいサーバーを読み込ませてください。

Claude Code and Cursor talk to firecrawl-local mcp over stdio; it scrapes, crawls and maps on your machine and only sends search and blocked pages to Firecrawl Cloud unless FIRECRAWL_CLOUD=off

Claude CodeでFirecrawl Localを手動設定する

ツールに設定を編集させたくない場合は、Claude CodeのMCPコマンドを使ってstdioサーバーを自分で追加します:

claude mcp add firecrawl -e FIRECRAWL_CLOUD=off -- ~/.cargo/bin/firecrawl-local mcp --public-only

Claude Code内で/mcpを実行し、サーバーが接続されていることを確認します。

CursorでFirecrawl Localを手動設定する

CursorはMCPサーバーを~/.cursor/mcp.json(グローバル)または.cursor/mcp.json(単一プロジェクト)から読み込みます。バイナリへのフルパスを使用してください:

{
  "mcpServers": {
    "firecrawl": {
      "command": "/Users/you/.cargo/bin/firecrawl-local",
      "args": ["mcp", "--public-only"],
      "env": { "FIRECRAWL_CLOUD": "off" }
    }
  }
}

--public-onlyを指定すると、サーバーはlocalhostおよびプライベートネットワークのアドレスを拒否します。信頼できないページをエージェントが読むときは、このオプションを有効にしておいてください。そうしないと、ページ内の隠れた指示によってエージェントが内部URLへ誘導される可能性があります。

ステップ4:エージェントに与えるプロンプト

firecrawl-local mcpはループバックポートでローカルAPIを起動し、そのAPIに対してfirecrawl-mcpパッケージを実行します。エージェントには標準のFirecrawl MCPツールが見え、scrape、crawl、map、batch scrapeは自分のマシン上で実行されます。ホスト型Firecrawl MCPサーバーを使ったことがあるなら、ツール名は同じです。

ローカルツールに適したプロンプト:

Map https://docs.example.com, then crawl only the /api/ pages (limit 40)
and write a summary of every endpoint into docs/vendor-api.md.
Scrape the changelog at https://example.com/changelog as markdown and list
every breaking change from the last three releases.
Batch scrape these five pricing pages and build a comparison table of
plan names and limits. Quote only what the pages say.

検索が必要なプロンプトは避けてください。FIRECRAWL_CLOUD=offでは、そのツールはどこにも接続しません。完全にローカルな検索環境については、Claude向けオープンソースWeb検索ガイドを参照してください。

ステップ5:Firecrawl Local APIを実行し、SDKの接続先を設定する

スクリプトやパイプラインで使うには、APIサーバーを実行します:

FIRECRAWL_CLOUD=off firecrawl-local serve

127.0.0.1:3002で待ち受けます。ヘルスチェックはすぐに応答します:

curl -s localhost:3002/health
# {"status":"ok","engine":"firecrawl-local","version":"0.1.0"}

スクレイピングはおなじみのv2形式で返され、次の2つのローカルマーカーが含まれます:"engine": "local-fetch"と"source": "local"、さらにcreditsUsed: 0です。

curl -s localhost:3002/v2/scrape -H 'content-type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown","links"]}'

Firecrawl SDKはAPIキーなしで接続先に指定できます。Python:

from firecrawl import Firecrawl

app = Firecrawl(api_url="http://localhost:3002")
print(app.scrape("https://example.com").markdown)

Node:

import { Firecrawl } from "firecrawl";

const app = new Firecrawl({ apiUrl: "http://localhost:3002" });
const doc = await app.scrape("https://example.com");
console.log(doc.markdown);

initはショートカットも提案します。FIRECRAWL_API_URL=http://127.0.0.1:3002を設定すれば、既存のFirecrawlコードがローカルで動作します。Firecrawl CLIは保存済みのログイン情報をFirecrawl Localと共有するため、どちらかのツールでloginすれば両方で使えます。

クロールは非同期です。POST /v2/crawlはすぐにジョブIDを返し、数秒後にGET /v2/crawl/{id}がstatus: completed、total: 10、creditsUsed: 0、expiresInSeconds: 3587を報告しました。ジョブはメモリ上に存在し、開始から1時間で期限切れになり、serveが停止すると消えます。そのため、クロールが完了したらすぐに結果を保存してください。

psで計測したところ、サーバープロセスの常駐メモリはアイドル時で約10 MB、10ページのクロール直後で43 MBでした。Firecrawlのローンチ投稿は、セルフホスト型Firecrawlより37倍高速でメモリ使用量が230分の1だと主張しています。READMEには測定方法が公開されていないため、これらはFirecrawlの公表値として扱ってください。

FIRECRAWL_CLOUDでFirecrawl Localを完全ローカル運用する

デフォルト(auto)では、3つのものがFirecrawl Cloudに送信されます。検索、マシンからのアクセスをブロックするページ、Alexandriaデータプロバイダー(firecrawl-local loginで無料アカウントが必要)です。FIRECRAWL_CLOUDはこの引き渡しを制御します:

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

認識されない値はoffとして扱われます。クラウドがオフの場合、POST /v2/searchは"code":"CLOUD_ONLY"と、FIRECRAWL_API_KEYまたはFIRECRAWL_CLOUD=autoを設定するよう促すメッセージを返します。クラウドが取得したページには"source": "firecrawl-cloud"が付くため、結果の出どころを常に判別できます。

serveは、--allow-privateを指定しない限りlocalhostおよびプライベートなターゲットを拒否します。また、ループバック以外の--hostにバインドするには--tokenが必要です。クラウドメタデータとリンクローカルアドレスは、すべてのモードでブロックされます。

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

クロールエンドポイントは、パイプラインを壊す可能性が最も高いものです。非同期であり、ジョブには期限があり、サーバーを停止するとジョブが失われます。手動でポーリングする代わりに、コーディングエージェントにApidog CLIでテストを構築・実行させましょう。

一度だけセットアップします:

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

次に、Claude CodeまたはCursorに次のプロンプトを1つ与えます:

firecrawl-local serve is running on http://localhost:3002. In Apidog project <id>,
import an OpenAPI file for POST /v2/scrape, POST /v2/crawl and GET /v2/crawl/{id},
create an environment for that base URL, and build a test scenario that starts a
crawl of https://docs.firecrawl.dev with limit 10, saves the returned id, polls
GET /v2/crawl/{id} until status is "completed", and asserts total equals completed
and every page has non-empty markdown. Run it and summarize any failures.
Sequence of the agent-built test: Apidog CLI posts /v2/crawl to firecrawl-local serve, polls GET /v2/crawl/{id} until completed, checks the assertions and writes a cli, json or junit report

エージェントは各ペイロードスキーマを読み取り、検証し、次のようなコマンドを実行します。これらはすべてCLI 2.2.12のapidog <cmd> --helpから取得したものです:

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-scenario-create
apidog cli-schema validate test-scenario-create --file scenario.json
apidog test-scenario create --project <id> --file ./scenario.json
apidog run -t <scenarioId> --project <id> -e <envId> -r cli,json

Apidog CLIはあなたのマシンからリクエストを送信するため、localhost:3002に到達できます。同じ実行をCIに組み込むには-r junitに切り替えます。Claude CodeでのApidog CLIとCursorでのApidog CLIのガイドでは、エージェント側の利用方法を説明しています。ApidogのFreeプランは最大4ユーザーのチームに対応しています。

Firecrawl Localのトラブルシューティング

症状 解決策
404とNOT_FOUNDが/v1/scrapeで返る v2のみが提供されています。クライアントを/v2/...に切り替えてください
CLOUD_ONLYが/v2/searchで返る FIRECRAWL_CLOUD=offでは想定どおりです。autoまたはsearchを使用してください
エージェントにFirecrawlツールが表示されない init後にツールを再起動してください。Node.js 22以降を確認してください
JavaScriptページの内容が薄い Chromeをインストールするか、--browser alwaysを設定してください
jsonまたはsummary形式が見つからない ローカルではサポートされていません。代わりに警告が表示されます
クロールIDが見つからない ジョブが1時間で期限切れになったか、serveが再起動されました

よくある質問

Firecrawl Localは無料ですか? ローカルのスクレイピング、クロール、マッピングはFirecrawlに何も送信せず、私たちのテストでは0クレジットでした。コードはAGPL-3.0、SDKはMITです。検索とAlexandriaはFirecrawl Cloudを経由します。

Firecrawl Localを使うにはAPIキーが必要ですか? いいえ、ローカルルートには不要です。Alexandriaデータプロバイダーを使う場合にのみ、firecrawl-local loginまたはFIRECRAWL_API_KEY経由でキーが必要です。

Firecrawl LocalはWindsurf、Codex、Gemini CLIで動作しますか? はい。initはClaude Code、Claude Desktop、Cursorに加えて、windsurf、codex、geminiにも対応しています。

既存のFirecrawlコードは変更なしで動作しますか? v2のscrape、map、crawl、batch scrapeについては、はい。API URLをhttp://localhost:3002に変更してください。v0およびv1のルートは提供されておらず、ブラウザのactionsは無視されます。

Firecrawl Localはrobots.txtを尊重しますか? はい。クロール時にrobots.txtを読み込み、User-Agentで自身を識別するため、サイト所有者はFirecrawlLocalとして対応できます。--ignore-robotsはこの動作を無効にします。自分の所有するサイトでのみ使用してください。

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

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