Firecrawl MCP Server

Firecrawl を統合し、ウェブの検索、スクレイピング、操作を可能にする Model Context Protocol (MCP) サーバー実装です。MCP サーバーはオープンソースで、GitHub から入手できます。

機能

Webを検索してページ全体のコンテンツを取得
任意のURLをスクレイピングして、クリーンな構造化データを取得
PDF、DOCX、XLSX、HTML などのローカルファイルを解析
ページ上でInteract — クリック、移動、操作
自律エージェントによる深層リサーチ
ブラウザセッション管理
クラウドおよびセルフホストに対応
Streamable HTTPサポート

インストール

リモートホストのURLを使用するか、サーバーをローカルで実行します。Firecrawl APIキーは https://firecrawl.dev/app/api-keys から取得してください。

Firecrawl APIキーがありませんか？スクレイピング、検索、Interact、解析はキー不要のリモートURLで利用できます。 キー不要のFreeティアを利用するには https://mcp.firecrawl.dev/v2/mcp に接続してください。無料ですが、IPごとにレート制限があり、他のツール (crawl、extract、map など) では利用できません。FIRECRAWL_API_KEY を設定すると、すべてのツールが使えるようになり、より高い上限も利用できます。Rate Limits を参照してください。

リモートホストのURL

API key を使用する場合 (すべてのツールと、より高い上限が利用可能) :

https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp

または、APIキーなしで接続して始めることもできます — リモートのAPIキー不要のFreeティアでは、スクレイピング、検索、Interact、解析を利用できます (IPごとにレート制限あり) :

https://mcp.firecrawl.dev/v2/mcp

npx での実行

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

手動インストール

npm install -g firecrawl-mcp

Cursor 上での実行

手動インストール

Cursor の設定 🖥️ 注意: Cursor バージョン 0.45.6 以上が必要です最新の設定手順は、MCP サーバーの構成に関する Cursor 公式ドキュメントをご参照ください: Cursor MCP Server Configuration Guide Cursor v0.48.6 で Firecrawl MCP を構成するには

Cursor Settings を開く
Features > MCP Servers に移動
「+ Add new global MCP server」をクリック

次のコードを入力:

{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Cursor v0.45.6 で Firecrawl MCP を構成するには

Cursor Settings を開く
Features > MCP Servers に移動
「+ Add New MCP Server」をクリック
次を入力:
- Name: “firecrawl-mcp” (任意の名称でも可)
- Type: “command”
- Command: env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp

Windows を使用していて問題が発生する場合は、cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp" を試してください

your-api-key をお持ちの Firecrawl API キーに置き換えてください。まだお持ちでない場合はアカウントを作成し、https://www.firecrawl.dev/app/api-keys から取得できます。追加後、MCP サーバー一覧を更新して新しいツールを確認してください。Composer Agent は適宜 Firecrawl MCP を自動的に使用しますが、ウェブデータの要件を記述することで明示的にリクエストすることも可能です。Command+L (Mac) で Composer を開き、送信ボタン横の「Agent」を選択してクエリを入力します。

Windsurf での実行

次を ./codeium/windsurf/model_config.json に追加します:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Streamable HTTP モードでの実行

デフォルトの stdio トランスポートではなく、ローカル環境で Streamable HTTP トランスポートを使ってサーバーを実行するには、次のようにします：

env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

次のURLを使用してください：http://localhost:3000/v2/mcp または https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp

Smithery 経由でのインストール (レガシー)

Smithery を使って Claude Desktop 用の Firecrawl を自動インストールするには：

npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude

VS Code での実行

ワンクリックでインストールするには、以下のインストールボタンのいずれかをクリックしてください。

手動でインストールするには、VS Code のユーザー設定 (JSON) ファイルに次の JSON ブロックを追加します。Ctrl + Shift + P を押し、Preferences: Open User Settings (JSON) と入力して開きます。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Firecrawl APIキー",
        "password": true
      }
    ],
    "servers": {
      "firecrawl": {
        "command": "npx",
        "args": ["-y", "firecrawl-mcp"],
        "env": {
          "FIRECRAWL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

必要に応じて、ワークスペース内の .vscode/mcp.json ファイルにこれを追加できます。そうすると、この設定を他の人と共有できるようになります。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Firecrawl API Key",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

注意: 一部のユーザーから、古いスキーマ形式で JSON を検証している VS Code の仕様が原因で、MCP サーバーを VS Code に追加する際に問題が発生するとの報告があります (microsoft/vscode#155379) 。この問題は Firecrawl を含む複数の MCP ツールに影響します。 回避策: MCP サーバーが正しく読み込まれるようにするため、VS Code の JSON 検証を無効化してください。参考: directus/directus#25906 (comment)。 MCP サーバーは他の拡張機能経由で呼び出した場合は問題なく動作しますが、MCP サーバー一覧に直接登録しようとした場合にのみ、この問題が発生します。VS Code がスキーマ検証を更新し次第、その設定方法についてのガイダンスを追記する予定です。

Claude Desktop での実行

Claude の設定ファイルに次を追加してください：

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

“Couldn’t reach the MCP server” エラーが表示される場合、お使いの Claude Desktop のバージョンでは streamable HTTP トランスポートがサポートされていない可能性があります。代わりにローカルの npx 方式を使用してください (Node.js が必要です) ：

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

spawn npx ENOENT エラーが表示される場合、Node.js がインストールされていないか、システムの PATH に登録されていません。nodejs.org から Node.js (LTS バージョン) をインストールし、その後 Claude Desktop を完全に再起動してください。Windows では、コマンドプロンプトで where npx を実行し、フルパス (例：C:\\Program Files\\nodejs\\npx.cmd) を command の値として使用することもできます。

Claude Code での実行

Claude Code の CLI を使って Firecrawl MCP サーバーを追加します。リモートホストのURLを使用することも、ローカルで実行することもできます：

# Remote hosted URL (recommended)
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/your-api-key/v2/mcp

# Or run locally via npx
claude mcp add firecrawl -e FIRECRAWL_API_KEY=your-api-key -- npx -y firecrawl-mcp

Google Antigravity 上での実行

Google Antigravity では、Agent インターフェースから直接 MCP サーバーを設定できます。

Editor または Agent Manager ビューで Agent サイドバーを開きます
”…” (More Actions) メニューをクリックし、MCP Servers を選択します
View raw config を選択して、ローカルの mcp_config.json ファイルを開きます
以下の設定を追加します：

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY"
      }
    }
  }
}

ファイルを保存し、Antigravity MCP インターフェースで Refresh をクリックして、新しいツールが表示されることを確認します。

YOUR_FIRECRAWL_API_KEY を、https://firecrawl.dev/app/api-keys から取得した API キーに置き換えてください。

n8n 上での実行

n8n で Firecrawl MCP サーバーに接続するには：

https://firecrawl.dev/app/api-keys から Firecrawl APIキーを取得する
n8n のワークフローで AI Agent ノードを追加する
AI Agent の設定で、新しい Tool を追加する
ツールタイプとして MCP Client Tool を選択する
MCP サーバーのエンドポイントを入力する ({YOUR_FIRECRAWL_API_KEY} を実際の APIキーに置き換える) :

  https://mcp.firecrawl.dev/{あなたのFirecrawl APIキー}/v2/mcp

Server Transport を HTTP Streamable に設定します
Authentication を None に設定します
Tools to include では All、Selected、または All Except を選択できます。これにより Firecrawl のツール (scrape、crawl、map、search、extract など) が利用可能になります。

セルフホスト環境でデプロイする場合は、npx で MCP server を実行し、HTTP transport モードを有効にします：

env HTTP_STREAMABLE_SERVER=true \
    FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
    FIRECRAWL_API_URL=YOUR_FIRECRAWL_INSTANCE \
    npx -y firecrawl-mcp

これによりサーバーが http://localhost:3000/v2/mcp で起動し、n8n のワークフロー内でエンドポイントとして利用できます。n8n では HTTP トランスポートが必要なため、環境変数 HTTP_STREAMABLE_SERVER=true を設定する必要があります。

設定

環境変数

Cloud APIで必須

FIRECRAWL_API_KEY: Firecrawl のAPIキー
- Cloud API (デフォルト) を使用する場合に必須
- FIRECRAWL_API_URL を指定したセルフホスト環境では任意
FIRECRAWL_API_URL (任意) : セルフホスト環境向けのカスタムAPIエンドポイント
- 例: https://firecrawl.your-domain.com
- 指定しない場合は Cloud API が使用されます (APIキーが必要)

省略可能な設定

リトライ設定

FIRECRAWL_RETRY_MAX_ATTEMPTS: リトライの最大試行回数 (既定値: 3)
FIRECRAWL_RETRY_INITIAL_DELAY: 初回リトライまでの遅延時間 (ミリ秒) (既定値: 1000)
FIRECRAWL_RETRY_MAX_DELAY: リトライ間の最大遅延時間 (ミリ秒) (既定値: 10000)
FIRECRAWL_RETRY_BACKOFF_FACTOR: 指数バックオフの係数 (既定値: 2)

クレジット使用量の監視

FIRECRAWL_CREDIT_WARNING_THRESHOLD: クレジット使用量の警告閾値 (既定: 1000)
FIRECRAWL_CREDIT_CRITICAL_THRESHOLD: クレジット使用量のクリティカル閾値 (既定: 100)

設定例

カスタムのリトライ設定とクレジット監視を備えたクラウド API の利用例:

# クラウド API 用に必須
export FIRECRAWL_API_KEY=your-api-key

# 任意のリトライ設定
export FIRECRAWL_RETRY_MAX_ATTEMPTS=5        # 最大リトライ回数を増やす
export FIRECRAWL_RETRY_INITIAL_DELAY=2000    # 初期遅延は 2 秒
export FIRECRAWL_RETRY_MAX_DELAY=30000       # 最大遅延は 30 秒
export FIRECRAWL_RETRY_BACKOFF_FACTOR=3      # より強めのバックオフ

# 任意のクレジット監視
export FIRECRAWL_CREDIT_WARNING_THRESHOLD=2000    # 2000 クレジットで警告
export FIRECRAWL_CREDIT_CRITICAL_THRESHOLD=500    # 500 クレジットで重大アラート

セルフホスト環境の場合:

# 自前ホスティングで必須
export FIRECRAWL_API_URL=https://firecrawl.your-domain.com

# 自前ホスティング向けの任意の認証
export FIRECRAWL_API_KEY=your-api-key  # インスタンスで認証が必要な場合

# リトライ設定のカスタマイズ
export FIRECRAWL_RETRY_MAX_ATTEMPTS=10
export FIRECRAWL_RETRY_INITIAL_DELAY=500     # より短い間隔からリトライ開始

Claude Desktop でのカスタム設定

次の内容を claude_desktop_config.json に追加します:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE",

        "FIRECRAWL_RETRY_MAX_ATTEMPTS": "5",
        "FIRECRAWL_RETRY_INITIAL_DELAY": "2000",
        "FIRECRAWL_RETRY_MAX_DELAY": "30000",
        "FIRECRAWL_RETRY_BACKOFF_FACTOR": "3",

        "FIRECRAWL_CREDIT_WARNING_THRESHOLD": "2000",
        "FIRECRAWL_CREDIT_CRITICAL_THRESHOLD": "500"
      }
    }
  }
}

システム構成

サーバーには、環境変数で設定可能な構成パラメータがいくつかあります。設定しなかった場合のデフォルト値は次のとおりです。

const CONFIG = {
  retry: {
    maxAttempts: 3, // レート制限されたリクエストの再試行回数
    initialDelay: 1000, // 最初の再試行前の初期遅延(ミリ秒)
    maxDelay: 10000, // 再試行間の最大遅延(ミリ秒)
    backoffFactor: 2, // 指数バックオフの倍率
  },
  credit: {
    warningThreshold: 1000, // クレジット使用量がこのレベルに達した際に警告
    criticalThreshold: 100, // クレジット使用量がこのレベルに達した際に重大アラート
  },
};

これらの設定は次の内容を制御します：

リトライ動作
- レート制限により失敗したリクエストを自動的に再試行します
- API を過負荷にしないよう、指数バックオフを使用します
- 例：デフォルト設定では、以下のタイミングでリトライが行われます
  - 1回目のリトライ：1秒の待機
  - 2回目のリトライ：2秒の待機
  - 3回目のリトライ：4秒の待機 (maxDelay で上限が設定されます)
クレジット使用状況の監視
- クラウド API 利用時の API クレジット消費量を追跡します
- 指定したしきい値で警告を出します
- 想定外のサービス中断を防ぐのに役立ちます
- 例：デフォルト設定では
  - 残り 1000 クレジットで警告
  - 残り 100 クレジットでクリティカルアラート

レート制限とバッチ処理

サーバーは、Firecrawl の組み込みのレート制限およびバッチ処理機能を利用しています:

指数バックオフ付きの自動レート制限処理
バッチ処理のための効率的な並列実行
スマートなリクエストのキューイングおよびスロットリング
一時的なエラーに対する自動再試行

利用可能なツール

1. スクレイプツール (`firecrawl_scrape`)

高度なオプションを使って、単一のURLからコンテンツをスクレイピングします。

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com",
    "formats": ["markdown"],
    "onlyMainContent": true,
    "waitFor": 1000,
    "mobile": false,
    "includeTags": ["article", "main"],
    "excludeTags": ["nav", "footer"],
    "skipTlsVerification": false
  }
}

個人を特定できる情報をマスキングするには、スクレイプツールの引数にredactPIIを含めます。

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com/contact",
    "formats": ["markdown"],
    "redactPII": true
  }
}

2. Map Tool (`firecrawl_map`)

ウェブサイトをマッピングして、サイト上でインデックスされているすべてのURLを洗い出します。

{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com",
    "search": "blog",
    "sitemap": "include",
    "includeSubdomains": false,
    "limit": 100,
    "ignoreQueryParameters": true
  }
}

Map Tool オプション:

url: マッピング対象となるウェブサイトのベース URL
search: URL をフィルタリングするための任意の検索語句
sitemap: サイトマップの利用方法を制御 - “include”、“skip”、“only” のいずれか
includeSubdomains: マッピング時にサブドメインを含めるかどうか
limit: 返す URL の最大件数
ignoreQueryParameters: マッピング時にクエリパラメータを無視するかどうか

最適な用途: 何をスクレイピングするか決める前にウェブサイト上の URL を探索する場合や、サイト内の特定セクションを見つける場合。 戻り値: サイト上で検出された URL の配列。

3. Search Tool (`firecrawl_search`)

ウェブを検索し、必要に応じて検索結果から内容を抽出します。

{
  "name": "firecrawl_search",
  "arguments": {
    "query": "検索クエリ",
    "limit": 5,
    "location": "United States",
    "tbs": "qdr:m",
    "scrapeOptions": {
      "formats": ["markdown"],
      "onlyMainContent": true
    }
  }
}

Search ツールのオプション:

query: 検索クエリ文字列 (必須)
limit: 返す結果の最大件数
location: 検索結果の地理的な場所
tbs: 時間ベースの検索フィルター (例: qdr:d 過去1日、qdr:w 過去1週間、qdr:m 過去1か月)
filter: 追加の検索フィルター
sources: 検索対象とするソース種別の配列 (web、images、news)
scrapeOptions: 検索結果ページをスクレイピングする際のオプション
enterprise: enterprise オプションの配列 (default、anon、zdr)

4. 解析ツール (`firecrawl_parse`)

PDF、DOCX、XLSX、HTML ドキュメントなどのローカルファイルを、クリーンで LLM 向けのデータに解析します。

{
  "name": "firecrawl_parse",
  "arguments": {
    "filePath": "/absolute/path/to/report.pdf",
    "formats": ["markdown"]
  }
}

FIRECRAWL_API_URL を使って Firecrawl MCP をローカルで Firecrawl API インスタンスに対して実行すると、MCP サーバーは filePath を直接読み取り、ファイルのバイト列を /v2/parse に送信できます。リモートでホストされている MCP サーバーを使用する場合、そのホストサーバーは手元のマシン上のファイルを読み取れません。そのため、firecrawl_parse はリモートの keyless URL でも動作する 2 段階の受け渡し方式を使用します。

filePath を指定して firecrawl_parse を呼び出します。ツールは、入力済みのアップロードコマンドと、uploadRef を含む nextToolCall を返します。
ファイルを読み取れるマシンでアップロードコマンドを実行し、返された uploadRef を使ってもう一度 firecrawl_parse を呼び出します。

アップロードコマンドは、ファイルのバイト列を短時間だけ有効な署名付きアップロード先に送信します。これに Firecrawl APIキーは含まれません。

解析ツールのオプション:

filePath: 解析するファイルのローカルパスです。最初の呼び出しではこれを使用します。
uploadRef: 最初の hosted-MCP 呼び出しで返される参照です。アップロード成功後の2回目の呼び出しで使用します。
formats: 出力フォーマットです。デフォルトは markdown です。
parsers: PDF の解析オプションなどのパーサー設定です。
contentType: 任意のファイル MIME タイプの上書きです。
declaredSizeBytes: 任意のファイルサイズの目安です。ファイルサイズの上限は 50 MB です。

最適な用途: 公開 URL で利用できないローカルまたは非公開のドキュメント。 推奨されない用途: 公開ドキュメントの URL。代わりに firecrawl_scrape を使用してください。URL からドキュメントを検出して解析します。

5. Crawl Tool (`firecrawl_crawl`)

高度なオプションを指定して非同期クロールを開始します。

{
  "name": "firecrawl_crawl",
  "arguments": {
    "url": "https://example.com",
    "maxDiscoveryDepth": 2,
    "limit": 100,
    "allowExternalLinks": false,
    "deduplicateSimilarURLs": true
  }
}

6. クロールのステータスを確認 (`firecrawl_check_crawl_status`)

クロールジョブのステータスを確認します。

{
  "name": "firecrawl_check_crawl_status",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

戻り値: クロールジョブのステータスおよび進捗状況 (可能であれば結果も含む) 。

7. Extract Tool (`firecrawl_extract`)

LLM の機能を使用して、Web ページから構造化情報を抽出します。クラウド型 AI とセルフホスト型 LLM の両方での抽出に対応しています。

{
  "name": "firecrawl_extract",
  "arguments": {
    "urls": ["https://example.com/page1", "https://example.com/page2"],
    "prompt": "Extract product information including name, price, and description",
    "schema": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "price": { "type": "number" },
        "description": { "type": "string" }
      },
      "required": ["name", "price"]
    },
    "allowExternalLinks": false,
    "enableWebSearch": false,
    "includeSubdomains": false
  }
}

レスポンス例:

{
  "content": [
    {
      "type": "text",
      "text": {
        "name": "Example Product",
        "price": 99.99,
        "description": "This is an example product description"
      }
    }
  ],
  "isError": false
}

Extract Tool オプション:

urls: 情報を抽出する対象の URL 配列
prompt: LLM による抽出に使用するカスタムプロンプト
schema: 構造化データ抽出用の JSON スキーマ
allowExternalLinks: 外部リンクからの抽出を許可するかどうか
enableWebSearch: 追加のコンテキストのためにウェブ検索を有効にするかどうか
includeSubdomains: 抽出対象にサブドメインを含めるかどうか

セルフホスト型インスタンスを使用する場合、抽出処理には構成済みの LLM が使用されます。クラウド API の場合は、Firecrawl のマネージド LLM サービスが使用されます。

8. Agent Tool (`firecrawl_agent`)

インターネットを自律的に閲覧し、情報を検索し、ページ間を移動し、クエリに基づいて構造化データを抽出する自律型のウェブリサーチエージェントです。非同期で動作し、まずジョブ ID を即座に返し、その後 firecrawl_agent_status をポーリングして完了を確認し、結果を取得します。

{
  "name": "firecrawl_agent",
  "arguments": {
    "prompt": "Find the top 5 AI startups founded in 2024 and their funding amounts",
    "schema": {
      "type": "object",
      "properties": {
        "startups": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "funding": { "type": "string" },
              "founded": { "type": "string" }
            }
          }
        }
      }
    }
  }
}

エージェントに重点的に処理させたい特定のURLを指定することもできます：

{
  "name": "firecrawl_agent",
  "arguments": {
    "urls": ["https://docs.firecrawl.dev", "https://firecrawl.dev/pricing"],
    "prompt": "Compare the features and pricing information from these pages"
  }
}

Agent Tool Options:

prompt: 取得したいデータの内容を自然言語で記述したもの (必須、最大 10,000 文字)
urls: エージェントを特定のページにフォーカスさせるためのオプションの URL 配列
schema: 構造化出力のためのオプションの JSON スキーマ

Best for: 正確な URL がわからない複雑なリサーチタスク、複数ソースからのデータ収集、ウェブ全体に散在する情報の検索、通常のスクレイピングでは失敗しがちな JavaScript 依存度の高い SPA からのデータ抽出。 Returns: ステータス確認用の Job ID。firecrawl_agent_status を使って結果をポーリングします。

9. エージェントのステータスを確認 (`firecrawl_agent_status`)

エージェントジョブのステータスを確認し、完了時に結果を取得します。15〜30秒ごとにポーリングし、リクエストが失敗したと見なす前に少なくとも2〜3分間はポーリングを続けてください。

{
  "name": "firecrawl_agent_status",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

エージェントステータスのオプション:

id: firecrawl_agent から返されるエージェントジョブ ID (必須)

取り得るステータス:

processing: エージェントがまだ調査中 — ポーリングを継続
completed: 調査完了 — レスポンスに抽出データが含まれる
failed: エラーが発生

戻り値: エージェントジョブのステータス、進行状況、および (完了している場合は) 結果。

10. ブラウザセッションの作成 (`firecrawl_browser_create`)

CDP (Chrome DevTools Protocol) 経由でコードを実行するための永続的なブラウザセッションを作成します。

{
  "name": "firecrawl_browser_create",
  "arguments": {
    "ttl": 120,
    "activityTtl": 60
  }
}

Browser Create オプション:

ttl: セッションの合計有効期間 (秒単位、30〜3600、省略可)
activityTtl: アイドル状態のタイムアウト (秒単位、10〜3600、省略可)

最適な用途: 実ブラウザページとやり取りするコード (Python/JS) の実行、複数ステップにわたるブラウザ自動化、複数回のツール呼び出しをまたいで維持されるプロファイル付きセッション。 戻り値: セッション ID、CDP URL、ライブビュー用 URL。

11. ブラウザでコードを実行する (`firecrawl_browser_execute`)

アクティブなブラウザセッション内でコードを実行できます。agent-browser のコマンド (Bash) 、Python、または JavaScript をサポートします。

{
  "name": "firecrawl_browser_execute",
  "arguments": {
    "sessionId": "session-id-here",
    "code": "agent-browser open https://example.com",
    "language": "bash"
  }
}

Playwright を使った Python のコード例:

{
  "name": "firecrawl_browser_execute",
  "arguments": {
    "sessionId": "session-id-here",
    "code": "await page.goto('https://example.com')\ntitle = await page.title()\nprint(title)",
    "language": "python"
  }
}

ブラウザー実行オプション:

sessionId: ブラウザーセッション ID (必須)
code: 実行するコード (必須)
language: bash、python、または node (任意、省略時は bash)

よく使う agent-browser コマンド (bash) :

agent-browser open <url> — 指定した URL に移動
agent-browser snapshot — クリック可能な参照付きのアクセシビリティツリーを取得
agent-browser click @e5 — スナップショットの参照を指定して要素をクリック
agent-browser type @e3 "text" — 要素にテキストを入力
agent-browser screenshot [path] — スクリーンショットを撮影
agent-browser scroll down — ページを下方向にスクロール
agent-browser wait 2000 — 2 秒待機

戻り値: stdout、stderr、終了コードを含む実行結果。

12. ブラウザセッションの削除 (`firecrawl_browser_delete`)

ブラウザセッションを削除します。

{
  "name": "firecrawl_browser_delete",
  "arguments": {
    "sessionId": "session-id-here"
  }
}

ブラウザ削除オプション:

sessionId: 破棄するブラウザセッションID (必須)

戻り値: 成功を示す確認。

13. ブラウザセッションの一覧 (`firecrawl_browser_list`)

ブラウザセッションを一覧表示し、必要に応じてステータスでフィルタリングできます。

{
  "name": "firecrawl_browser_list",
  "arguments": {
    "status": "active"
  }
}

ブラウザーリストのオプション:

status: セッションのステータスでフィルタリングします — active または destroyed (任意)

戻り値: ブラウザーセッションの配列を返します。

14. スクレイピングしたページを Interact (`firecrawl_interact`)

以前にスクレイピングしたページを、ライブのブラウザセッションで操作します。まず firecrawl_scrape でページをスクレイピングし、次に返された scrapeId (スクレイピングのレスポンスメタデータ内) を使って、ボタンをクリックしたり、フォームに入力したり、動的コンテンツを抽出したり、さらに深いページへ移動したりできます。レスポンスには liveViewUrl と interactiveLiveViewUrl が含まれており、これらをブラウザで開くと、セッションをリアルタイムで確認または操作できます。

{
  "name": "firecrawl_interact",
  "arguments": {
    "scrapeId": "scrape-id-from-previous-scrape",
    "prompt": "Click the Sign In button"
  }
}

Interact ツールのオプション:

scrapeId: 前回の firecrawl_scrape 呼び出しで取得した scrape job ID (必須)
prompt: 実行するアクションを自然言語で指示するプロンプト (prompt または code を指定)
code: ブラウザセッションで実行するコード (code または prompt を指定)
language: bash、python、または node (任意、デフォルトは node、code 使用時のみ使用)
timeout: 実行タイムアウト (秒) 、1～300 (任意、デフォルトは 30)

最適な用途: 1つのページ内で複数ステップのワークフローを実行する場合 — サイト内検索、検索結果のクリックによる遷移、フォーム入力、操作が必要なデータの抽出。 戻り値: liveViewUrl と interactiveLiveViewUrl を含むインタラクション結果。

15. Interact セッションの停止 (`firecrawl_interact_stop`)

スクレイピングしたページの Interact セッションを停止します。リソースを解放するため、操作を終えたらこれを呼び出してください。

{
  "name": "firecrawl_interact_stop",
  "arguments": {
    "scrapeId": "scrape-id-from-previous-scrape"
  }
}

Interact 停止オプション:

scrapeId: 停止するセッションの scrapeId (必須)

戻り値: セッションが停止されたことの確認。

ログシステム

サーバーには包括的なログ機能があります:

操作のステータスと進捗
パフォーマンス指標
クレジット使用状況の監視
レート制限のトラッキング
エラー状況

ログメッセージの例:

[INFO] Firecrawl MCP Server initialized successfully
[INFO] URL のスクレイピングを開始: https://example.com
[INFO] Starting crawl for URL: https://example.com
[WARNING] Credit usage has reached warning threshold
[ERROR] Rate limit exceeded, retrying in 2s...

エラーハンドリング

サーバーは堅牢なエラーハンドリング機能を提供します：

一時的なエラーに対する自動リトライ
バックオフを伴うレート制限への対応
詳細なエラーメッセージ
クレジット使用量に関する警告
ネットワーク障害への耐性

エラーレスポンスの例：

{
  "content": [
    {
      "type": "text",
      "text": "Error: Rate limit exceeded. Retrying in 2 seconds..."
    }
  ],
  "isError": true
}

開発

# 依存関係のインストール
npm install

# ビルド
npm run build

# テストの実行
npm test

コントリビュート方法

リポジトリをフォークする
機能ブランチを作成する
テストを実行する: npm test
プルリクエストを作成して送信する

貢献者への感謝

初期実装にご尽力いただいた @vrknetha、@cawstudios に感謝します。ホスティングしていただいた MCP.so と Klavis AI、ならびに当社サーバーの統合にご協力いただいた @gstarwd、@xiangkaiz、@zihaolin96 に感謝します。

ライセンス

MIT ライセンス — 詳細は LICENSE ファイルをご覧ください

AIで開発

高度なスクレイピングガイド

​機能

​インストール

​リモートホストのURL

​npx での実行

​手動インストール

​Cursor 上での実行

​手動インストール

​Windsurf での実行

​Streamable HTTP モードでの実行

​Smithery 経由でのインストール (レガシー)

​VS Code での実行

​Claude Desktop での実行

​Claude Code での実行

​Google Antigravity 上での実行

​n8n 上での実行

​設定

​環境変数

​Cloud APIで必須

​省略可能な設定

リトライ設定

クレジット使用量の監視

​設定例

​Claude Desktop でのカスタム設定

​システム構成

​レート制限とバッチ処理

​利用可能なツール

​1. スクレイプツール (firecrawl_scrape)

​2. Map Tool (firecrawl_map)

​Map Tool オプション:

​3. Search Tool (firecrawl_search)

​Search ツールのオプション:

​4. 解析ツール (firecrawl_parse)

​解析ツールのオプション:

​5. Crawl Tool (firecrawl_crawl)

​6. クロールのステータスを確認 (firecrawl_check_crawl_status)

​7. Extract Tool (firecrawl_extract)

​Extract Tool オプション:

​8. Agent Tool (firecrawl_agent)

​Agent Tool Options:

​9. エージェントのステータスを確認 (firecrawl_agent_status)

​エージェントステータスのオプション:

​10. ブラウザセッションの作成 (firecrawl_browser_create)

​Browser Create オプション:

​11. ブラウザでコードを実行する (firecrawl_browser_execute)

​ブラウザー実行オプション:

​12. ブラウザセッションの削除 (firecrawl_browser_delete)

​ブラウザ削除オプション:

​13. ブラウザセッションの一覧 (firecrawl_browser_list)

​ブラウザーリストのオプション:

​14. スクレイピングしたページを Interact (firecrawl_interact)

​Interact ツールのオプション:

​15. Interact セッションの停止 (firecrawl_interact_stop)

​Interact 停止オプション:

​ログシステム

​エラーハンドリング

​開発

​コントリビュート方法

​貢献者への感謝

​ライセンス

機能

インストール

リモートホストのURL

npx での実行

手動インストール

Cursor 上での実行

手動インストール

Windsurf での実行

Streamable HTTP モードでの実行

Smithery 経由でのインストール (レガシー)

VS Code での実行

Claude Desktop での実行

Claude Code での実行

Google Antigravity 上での実行

n8n 上での実行

設定

環境変数

Cloud APIで必須

省略可能な設定

設定例

Claude Desktop でのカスタム設定

システム構成

レート制限とバッチ処理

利用可能なツール

1. スクレイプツール (`firecrawl_scrape`)

2. Map Tool (`firecrawl_map`)

Map Tool オプション:

3. Search Tool (`firecrawl_search`)

Search ツールのオプション:

4. 解析ツール (`firecrawl_parse`)

解析ツールのオプション:

5. Crawl Tool (`firecrawl_crawl`)

6. クロールのステータスを確認 (`firecrawl_check_crawl_status`)

7. Extract Tool (`firecrawl_extract`)

Extract Tool オプション:

8. Agent Tool (`firecrawl_agent`)

Agent Tool Options:

9. エージェントのステータスを確認 (`firecrawl_agent_status`)

エージェントステータスのオプション:

10. ブラウザセッションの作成 (`firecrawl_browser_create`)

Browser Create オプション:

11. ブラウザでコードを実行する (`firecrawl_browser_execute`)

ブラウザー実行オプション:

12. ブラウザセッションの削除 (`firecrawl_browser_delete`)

ブラウザ削除オプション:

13. ブラウザセッションの一覧 (`firecrawl_browser_list`)

ブラウザーリストのオプション:

14. スクレイピングしたページを Interact (`firecrawl_interact`)

Interact ツールのオプション:

15. Interact セッションの停止 (`firecrawl_interact_stop`)

Interact 停止オプション:

ログシステム

エラーハンドリング

開発

コントリビュート方法

貢献者への感謝

ライセンス