キーレス無料利用枠では、`scrape`、`search`、`interact` は API キーなしで動作します（レート制限あり）。`crawl`、`map`、`agent`、`extract` などの他のツールは依然としてキーが必要です。

人間がサインアップできる場合は、API キーまたは OAuth を優先してください。これにより、ツールセット全体とより高い制限が解放されます。キーを使用する場合は、次を使用します：```
https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp

### 手動インストール```bash
npm install -g firecrawl-mcp

### Streamable HTTP Local Mode での実行

デフォルトの stdio トランスポートの代わりに、Streamable HTTP をローカルで使用してサーバーを実行するには:```bash
env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

### VS Code での実行

ワンクリックインストールの場合は、以下のインストールボタンのいずれかをクリックしてください...

[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=firecrawl&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22Firecrawl%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22firecrawl-mcp%22%5D%2C%22env%22%3A%7B%22FIRECRAWL_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=firecrawl&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22Firecrawl%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22firecrawl-mcp%22%5D%2C%22env%22%3A%7B%22FIRECRAWL_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D&quality=insiders)

手動インストールの場合は、以下のJSONブロックをVS Codeのユーザー設定（JSON）ファイルに追加してください。これは、`Ctrl + Shift + P` を押して `Preferences: Open User Settings (JSON)` と入力することで行えます。```json
{
  "mcp": {
    "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}"
        }
      }
    }
  }
}

## 設定

### 環境変数

#### クラウドAPIに必須

- `FIRECRAWL_API_KEY`: Firecrawl APIキー
  - クラウドAPIを使用する場合に必須（デフォルト）
  - `FIRECRAWL_API_URL`を使用したセルフホストインスタンスの場合は省略可能
- `FIRECRAWL_API_URL`（オプション）: セルフホストインスタンス用のカスタムAPIエンドポイント
  - 例: `https://firecrawl.your-domain.com`
  - 指定しない場合、クラウドAPIが使用されます（APIキーが必要）

#### MCP OAuth（Bearerアクセストークン）

ホスト型Firecrawlは、[firecrawl.dev](https://firecrawl.dev)の認可サーバーを通じてOAuth **アクセストークン**（`fco_…`）を発行できます。このMCPサーバーは、解決された認証情報をFirecrawl APIに`Authorization: Bearer …`として転送します。

- **HTTPストリームトランスポート**（`CLOUD_SERVICE=true`、`HTTP_STREAMABLE_SERVER=true`、または`SSE_LOCAL=true`）: クライアントはMCPリクエストで`Authorization: Bearer <fco_access_token>`を送信する必要があります。OAuth Bearerトークンは、両方が存在する場合、`x-firecrawl-api-key` / `x-api-key`よりも優先されます。
- **stdio:** 静的アクセストークンには`FIRECRAWL_OAUTH_TOKEN`を使用するか、APIキーには引き続き`FIRECRAWL_API_KEY`を使用します。

**アクセス**トークン（`fco_…`）のみを使用してください。リフレッシュトークン（`fcr_…`）はトークンエンドポイントで交換する必要があり、スクレイプ/検索APIに渡してはなりません。

### 設定例

クラウドAPIを使用する場合:```bash
export FIRECRAWL_API_KEY=your-api-key

### Claude Desktopでの使用方法

これをあなたの`claude_desktop_config.json`に追加してください：```json
{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

**使用例（マークダウン形式 - 全文が必要な場合）：**```json
{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com/article",
    "formats": ["markdown"],
    "onlyMainContent": true
  }
}

**ブランディング形式:** デザイン分析やスタイル再現のために包括的なブランドID（色、フォント、タイポグラフィ、スペーシング、ロゴ、UIコンポーネント）を抽出します。
**プライバシー:** `redactPII: true` を設定すると、個人を特定できる情報が編集されたコンテンツが返されます。

**戻り値:**

- JSON構造化データ、マークダウン、ブランディングプロファイル、または指定されたその他の形式。

### 2. マップツール (`firecrawl_map`)

ウェブサイトをマッピングして、サイト上のすべてのインデックス付きURLを検出します。

**最適な用途:**

- スクレイピングする前にウェブサイト上のURLを発見する
- ウェブサイトの特定のセクションを見つける

**推奨しない場合:**

- 必要な特定のURLがすでにわかっている場合（スクレイピングを使用）
- ページのコンテンツが必要な場合（マッピング後にスクレイピングを使用）

**よくある間違い:**

- URLの発見にクロールを使用する代わりにマップを使用する

**プロンプト例:**

> "example.com 上のすべてのURLをリスト表示してください。"

**使用例:**```json
{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com"
  }
}

**戻り値:**

- 検索結果の配列（オプションでスクレイピングされたコンテンツを含む）と、`id` フィールド。結果を使用した後、その `id` を `firecrawl_search_feedback` に渡して、1クレジットを返金し（検索コストは2）、検索品質を向上させます。

**プロンプト例:**

> "2023年に発表されたAIに関する最新の研究論文を見つけてください。"

### 3b. 検索フィードバックツール (`firecrawl_search_feedback`)

以前の `firecrawl_search` 結果に対する構造化フィードバックを送信します。各検索IDの最初のフィードバックは1クレジットを返金し、Firecrawlの検索品質を向上させます。検索IDごとに冪等です。

**実際に使用した（または役に立たなかった）すべての検索後にこれを呼び出してください。** `missingContent` を含む悪い/部分的なフィードバックは、良いフィードバックと同じくらい価値があります。

**オプトアウト:** MCPサーバー起動時に環境変数 `FIRECRAWL_NO_SEARCH_FEEDBACK=1`（または `FIRECRAWL_DISABLE_SEARCH_FEEDBACK=1`）を設定します。`firecrawl_search_feedback` ツールは登録されず、エージェントはそれを呼び出せなくなります。チーム管理者はサーバー側でフィードバックを無効にすることもできます。その場合、ツールは登録されていますが、常に `feedbackErrorCode: "TEAM_OPTED_OUT"` を返します。

**最も重要なフィールド:** `missingContent`。これは、エージェントが見つけることを期待していたが見つからなかった特定のコンテンツの配列です。欠落しているトピックごとに1つのエントリがあります。これらはチーム間で集約され、次に何をインデックスすべきかを示します。

**毎日の返金上限（チームごと、UTC日ごと、デフォルト100クレジット）。** チームの `creditsRefundedToday` が `dailyRefundCap` に達すると、それ以降の送信はフィードバックを記録しますが、クレジットは返金されません。応答は `dailyCapReached: true` を設定します。エージェントはこのフラグを確認したら、そのUTC日の残りの間、このツールの呼び出しを停止する必要があります。

**使用例:**```json
{
  "name": "firecrawl_search_feedback",
  "arguments": {
    "searchId": "0193f6c5-1234-7890-abcd-1234567890ab",
    "rating": "good",
    "valuableSources": [
      {
        "url": "https://docs.firecrawl.dev/features/search",
        "reason": "Most up-to-date description of /search."
      }
    ],
    "missingContent": [
      {
        "topic": "Pricing for the search endpoint",
        "description": "No pricing tier table for /search specifically."
      },
      { "topic": "Per-team rate limits" }
    ],
    "querySuggestions": "Boost docs.firecrawl.dev for queries that mention 'firecrawl'"
  }
}

**戻り値：**

- `{ success, feedbackId, creditsRefunded, creditsRefundedToday?, dailyRefundCap?, dailyCapReached?, alreadySubmitted?, warning? }` JSON。

### 4. クロールツール（`firecrawl_crawl`）

クロールジョブを開始し、終了状態になるまでポーリングし、最終的なクロール状態/データを返します。

**最適な用途：**

- 複数の関連ページからコンテンツを抽出する場合、包括的なカバレッジが必要なとき。

**非推奨な用途：**

- 単一ページからコンテンツを抽出する場合（スクレイプを使用）
- トークン制限が懸念される場合（より細かい制御のためにマップ + スクレイプを使用）
- 高速な結果が必要な場合（クロールは遅い可能性があります）

**警告：** クロールの応答は非常に大きくなる可能性があり、トークン制限を超える場合があります。クロールの深さとページ数を制限するか、より細かい制御のためにマップ + スクレイプを使用してください。

**よくある間違い：**

- リミットや maxDiscoveryDepth を高く設定しすぎる（トークンオーバーフローの原因）
- 単一ページに対してクロールを使用する（代わりにスクレイプを使用）

**プロンプト例：**

> "example.com/blog の最初の2階層からすべてのブログ投稿を取得する。"

**使用例：**```json
{
  "name": "firecrawl_crawl",
  "arguments": {
    "url": "https://example.com/blog/*",
    "maxDiscoveryDepth": 2,
    "limit": 100,
    "allowExternalLinks": false,
    "deduplicateSimilarURLs": true
  }
}

**戻り値:**

- クロールジョブのステータスを含むレスポンス

### 6. パースツール (`firecrawl_parse`)

Firecrawlの`/v2/parse`エンドポイントを使用してローカルファイルまたはホストされたアップロード参照をパースします。

**最適な用途:** PDF、Word文書、スプレッドシート、HTMLファイル、およびマークダウンや構造化JSON出力を必要とするその他のドキュメント。ホスト型MCPは2ステップのアップロード参照フローをサポートしています。ローカルでの直接ファイル読み取りには、自己ホスト型の`FIRECRAWL_API_URL`が必要です。

**推奨しない用途:** リモートURL（scrapeを使用）、1回の呼び出しで複数のファイル（ファイルごとにparseを呼び出す）、スクリーンショットやクリックなどのブラウザのみのアクション。

**ホスト型MCPのフロー:** ホスト型MCPは呼び出し元のファイルシステムを直接読み取ることができません。`firecrawl_parse`を`filePath`付きで呼び出して、有効期限の短いアップロードコマンドと`nextToolCall`を受け取り、ローカルでファイルをアップロードしてから、返された`uploadRef`を使用して再度`firecrawl_parse`を呼び出します。ホスト型アップロードURLの発行にはFirecrawlの認証またはキーレス資格が必要です。ローカルの`npx firecrawl-mcp`モードでは、直接ファイルパースには現在自己ホスト型のFirecrawl APIを指す`FIRECRAWL_API_URL`が必要です。単なるクラウドAPIキーのみのローカルサーバーでは、このツールを介してファイルを読み取りおよびアップロードすることはできません。

**使用例:**```json
{
  "name": "firecrawl_parse",
  "arguments": {
    "filePath": "/absolute/path/to/document.pdf",
    "formats": ["markdown"],
    "parsers": ["pdf"],
    "zeroDataRetention": true
  }
}

**戻り値:**

- スキーマで定義された抽出済み構造化データ```json
{
  "content": [
    {
      "type": "text",
      "text": {
        "name": "Example Product",
        "price": 99.99,
        "description": "This is an example product description"
      }
    }
  ],
  "isError": false
}

次に、返されたジョブIDを使用して`firecrawl_agent_status`をポーリングします。

**使用例（URL付き - エージェントが特定のページに焦点を当てる）：**```json
{
  "name": "firecrawl_agent",
  "arguments": {
    "urls": ["https://docs.firecrawl.dev", "https://firecrawl.dev/pricing"],
    "prompt": "Compare the features and pricing information from these pages"
  }
}

**可能なステータス:**

- `processing`: エージェントが調査中 - 後で確認してください
- `completed`: 調査完了 - レスポンスに抽出データが含まれます
- `failed`: エラーが発生しました

### 10. Interact Tool (`firecrawl_interact`)

新しいURL、または `firecrawl_scrape` で既に開かれたページと対話します。

**最適な用途:** 非推奨のブラウザツールを復元することなく、動的ページでのクリック、入力、ナビゲーション、状態の抽出。

**使用オプション:**

- `url` を渡してスクレイピングし、1回のMCP呼び出しで対話用ページを開く。
- `scrapeId` を渡して、既存のスクレイピング済みページとの対話を続ける。
- `url` または `scrapeId` のいずれか一方に加え、`prompt` または `code` のいずれかを正確に渡す。

**使用例:**```json
{
  "name": "firecrawl_interact",
  "arguments": {
    "url": "https://example.com",
    "prompt": "Click the pricing link and summarize the visible plans"
  }
}

### 12. 研究ツール (`firecrawl_research_*`)

研究MCPツールを通じて論文やGitHubリポジトリを検索・調査します。

**利用可能な研究ツール:**

- `firecrawl_research_search_papers`: 研究論文を検索します。
- `firecrawl_research_inspect_paper`: 1件の論文を詳しく調べます。
- `firecrawl_research_related_papers`: 関連論文を見つけます。
- `firecrawl_research_read_paper`: 論文の内容を読みます。
- `firecrawl_research_search_github`: GitHubリポジトリを検索します。

**最適な用途:** 文献レビュー、論文検索、リポジトリ発見のワークフローにおいて、エージェントが汎用的なウェブスクレイピングではなく焦点を絞った研究表面を必要とする場合。

### 13. 監視ツール (`firecrawl_monitor_*`)

定期的なページ監視を作成・管理します。監視はスケジュールされたスクレイピングまたはクロールを実行し、各結果を最後に保持したスナップショットと比較し、ウェブフックまたはメールで通知できます。

**最適な用途:**

- 1ページまたは数ページを経時的に監視する
- 平易な英語の目標（goal）を使用して意味のある変更をアラートする
- チェック履歴とページレベルの差分を追跡する

**推奨される作成パターン:**

`page` または `pages` に加えて `goal` を使用します。MCPサーバーは30分間隔のスケジュールで監視リクエストを構築し、APIが自動的に意味のある変更の判断を有効にします。

`goal` が設定されている場合、意味のある変更の判断は自動的に実行されます。ページウェブフックは `monitor.page` イベントで `isMeaningful` と `judgment` を公開します。

目標（goal）は簡潔で2～3文の監視指示として記述します。アラートをトリガーすべき内容を述べ、ユーザーが与えた範囲を保持し、リクエストから明らかな場合にのみ意図固有の除外事項を含めます。空白、書式のみの変更、リクエストID、トラッキングパラメータ、汎用的なメタデータ、無関係なページクロームなどの一般的なノイズは既に判断機能によって処理されるため、すべての目標に繰り返し記述しないでください。ユーザーが曖昧な場合は目標を広く保ちます。ユーザーが広範な監視や「どんな変更でも」を求めた場合は、それを保持します。ユーザーが何かを気にしないと言った場合は、それを明示的に含めます。```json
{
  "name": "firecrawl_monitor_create",
  "arguments": {
    "page": "https://example.com/pricing",
    "goal": "Alert when pricing, packaging, or launch messaging changes."
  }
}

**高度な作成リクエスト:**

クロールターゲット、JSON変更追跡、カスタム保持、または明示的な`judgeEnabled`制御が必要な場合は、`body`を渡します。```json
{
  "name": "firecrawl_monitor_create",
  "arguments": {
    "body": {
      "name": "Docs monitor",
      "schedule": { "text": "hourly", "timezone": "UTC" },
      "goal": "Alert when docs pages add, remove, or materially change API behavior.",
      "targets": [{ "type": "crawl", "url": "https://example.com/docs" }]
    }
  }
}

## エラーハンドリング

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

- APIレート制限エラーがMCPクライアントに通知されます
- 詳細なエラーメッセージ
- ネットワークの回復力

エラーレスポンスの例：```json
{
  "content": [
    {
      "type": "text",
      "text": "Error: Rate limit exceeded"
    }
  ],
  "isError": true
}

### コントリビューション

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. テストを実行する: `npm test`
4. プルリクエストを送信する

### コントリビューターへの感謝

初期実装にご協力いただいた [@vrknetha](https://github.com/vrknetha)、[@cawstudios](https://caw.tech) に感謝します！

ホスティングを提供してくれた MCP.so と Klavis AI、そしてサーバーを統合してくれた [@gstarwd](https://github.com/gstarwd)、[@xiangkaiz](https://github.com/xiangkaiz)、[@zihaolin96](https://github.com/zihaolin96) に感謝します。

## ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。