Firecrawl MCP Server注目

@mendableai

リポジトリホームページ

基本情報

カテゴリ

ブラウザ自動化

ライセンス

MIT

トランスポート

stdio

作者

mendableai

投稿者

Victor Bruno Castro

Firecrawl MCP Server について

🔥 公式 Firecrawl MCP サーバー - Cursor、Claude、その他あらゆる LLM クライアントに強力な Web スクレイピングと検索機能を追加します。

#web-crawler #web-scraping #data-collection #batch-processing #content-extraction #search-api #claude #llm-tools #firecrawl #model-context-protocol #mcp-server#firecrawl-ai#javascript-rendering

Firecrawl MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

Firecrawl MCP Server のツール

Retrieve and extract content from one supplied URL through Firecrawl. Use this when the request identifies a page and needs its content or defined fields. It can return markdown, HTML, links, screenshots, branding data, a targeted answer, or JSON matching a supplied schema; JSON is useful when the requested result has defined fields, while markdown preserves readable page content. This tool operates on a known page. For a set of pages use `firecrawl_crawl`, and to discover page URLs use `firecrawl_map` or `firecrawl_search`. Options include JavaScript render delay, cache age, main-content filtering, PII redaction, and lockdown cache-only retrieval. Browser actions may change the live page when interactive actions are enabled. Firecrawl may reuse recently indexed content instead of refetching the page, and the reuse window varies by domain. Set `maxAge: 0` to force a live fetch, or a smaller `maxAge` to bound how stale reused content may be. A successful response does not by itself confirm that the state it describes is still current. Returns the selected content formats and page metadata.

Enumerate URLs indexed under one website through Firecrawl without fetching each page's content. Use this when the request asks for a site's URL inventory, when several relevant pages must be located, or when the desired page URL is unknown. An optional `search` term narrows the URL list, while sitemap, subdomain, query-parameter, and result-limit options control coverage. Returns matching URLs rather than page bodies. Retrieve one page with `firecrawl_scrape`; collect content across multiple pages with `firecrawl_crawl`.

Search web, news, or image sources and return ranked results. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. `includeDomains` and `excludeDomains` are mutually exclusive hostname filters; categories limit results to GitHub, research, PDF, or developer sources. For a programming question, add `categories: ["developer"]`. It searches an index of GitHub issues, merged pull requests, repository READMEs, and curated documentation sites, and returns the hits in `data.developer` beside the web results. `categories: ["research"]` restricts these web results to research-affiliated websites and returns page snippets. The `firecrawl_research_*` tools are a separate surface that searches paper abstracts and full text across biomedical (PubMed, bioRxiv, medRxiv) and arXiv literature. `scrapeOptions` can attach extracted page content; pages fetched this way use a fixed reuse window and ignore `maxAge`, so use `firecrawl_scrape` when a live fetch is required. Returns source-type result groups and usage metadata. Authenticated responses can include an `id` for optional search feedback.

Records schema-validated quality feedback for a prior `firecrawl_search` UUID `searchId`. A `good` rating requires a valuable source, `partial` a valuable source or at least one `missingContent` entry, and `bad` at least one `missingContent` entry or a query suggestion; caps are 50 `valuableSources` and 20 `missingContent` entries. Eligibility is limited to successful searches within the feedback age window. The record is idempotent per search ID. Eligible first feedback for a search can refund 1 credit; refunds are subject to the team's daily cap. The response reports whether a refund was applied, along with submission and daily-cap status.

Submit concise quality feedback for a completed search, scrape, parse, or map job. Provide the endpoint, job ID, rating, and relevant issue codes or small contextual fields; omit large page contents and raw outputs. Returns submission status, feedback ID, and accounting fields.

Start a multi-page crawl at a website URL, poll it to a terminal state, and return the final status and collected data. Scope can be bounded with include/exclude paths, depth, page limit, subdomain/external-link controls, sitemap handling, delay, and scrape options. Crawl results can be large; use conservative limits when full-site coverage is unnecessary. Webhooks and interactive scrape actions are unavailable in safe mode. Returns the crawl ID, status, and page data.

Retrieve the current status, progress, and available results for an existing crawl ID. This only reads Firecrawl job state and does not start or modify the crawl.

Deprecated compatibility entry point. Use firecrawl_scrape once per known URL with formats: ["json"] and jsonOptions containing the prompt and schema. Use firecrawl_search or firecrawl_agent before Scrape when URLs are not known.

Start an asynchronous web research job from a prompt, optional seed URLs, and an optional JSON schema. Use this for a requested synthesis across multiple sources when the task can wait for asynchronous completion. The agent can search, navigate, read pages, and assemble a structured result. This call returns only a job ID, not the research result. Read the job with `firecrawl_agent_status` until it reaches `completed` or `failed`; research commonly takes several minutes. If the job cannot finish within the task's available time, `firecrawl_search` and `firecrawl_scrape` can gather evidence synchronously.

Retrieve progress or final results for a `firecrawl_agent` job ID. A `processing` response is non-terminal and does not contain the final research result. Check again after 15–30 seconds until the status is `completed` or `failed`; complex jobs can take several minutes. If the job cannot finish within the task's available time, use `firecrawl_search` and `firecrawl_scrape` to complete the requested output. Returns job status, progress information, and result data when completed.

Open or reuse a live browser session to navigate a page, click controls, fill fields, or run browser code. Provide either `url` or `scrapeId`, and either a natural-language `prompt` or executable `code`; code can run as Bash, Python, or Node with a bounded timeout. This acts on the live site, so actions such as form submission can create persistent external side effects. Returns execution output, stdout/stderr, exit status, and session viewing URLs.

Stop the live interact session associated with a `scrapeId` and release its resources. Returns a success confirmation.

Parse one supported document into markdown, HTML, links, summary, targeted answers, or JSON matching a schema. Supported inputs include common HTML, PDF, Word, RTF, OpenDocument, and spreadsheet files; PDF parsing can be bounded with `pdfOptions.maxPages`. Local MCP reads `filePath` from the server filesystem. Hosted MCP uses two calls: first provide `filePath` to receive upload instructions, upload locally, then call again with the returned `uploadRef`; do not send both fields together. Remote web URLs belong in `firecrawl_scrape`. Set `redactPII` to request redaction of personally identifiable information in the returned content. `zeroDataRetention` requires an eligible authenticated account; omit it for anonymous keyless use. Returns upload instructions for hosted phase one or parsed document content for the final call.

Create a recurring scrape, crawl, or search monitor that compares each check with its retained predecessor. The simple form accepts `page`/`pages` or `queries` plus a plain-language `goal`; the advanced `body` form controls targets, schedule, change-tracking formats, judging, retention, webhook, and notifications. In the simple form, a `goal` is required. If `queries` contains one or more non-empty values and is supplied with `page`/`pages`, `queries` create the search target and page targets are ignored. A monitor schedules future network checks and can send configured email or webhook notifications. Returns the created monitor.

List monitors for the authenticated account with optional pagination controls. Returns one page of monitor records and pagination metadata.

Retrieve one monitor by ID, including its configuration and current state. This does not run or modify the monitor.

Patch an existing monitor by ID. The body can change its name, active/paused status, schedule, targets, goal, judging, webhook, notifications, or retention; these changes affect future scheduled checks. Returns the updated monitor.

Permanently delete a monitor by ID and stop its future schedule. This operation cannot be undone and returns deletion status.

Queue an immediate check for a monitor outside its normal schedule. This starts network work for the monitor's configured targets and returns the queued check.

List historical checks for a monitor, optionally filtered by status and bounded by a result limit. Returns one page of check summaries and pagination metadata.

Retrieve one monitor check and its page-level results, optionally filtered by page status. Pages report `same`, `new`, `changed`, `removed`, or `error`; configured goal judging can add a meaningful-change decision. Markdown tracking returns a unified text diff, JSON tracking returns field paths with previous/current values and a current snapshot, and mixed tracking returns both. Returns one page of results plus a `next` URL when more pages exist.

Search paper metadata and abstracts with a natural-language query across the indexed corpus, which spans biomedical, life-science, and clinical literature (PubMed, bioRxiv, medRxiv) alongside arXiv and other scientific sources. Optional author, category, and date filters constrain results. Several distinct framings of the same question surface different papers than a single query does. Returns ranked papers with canonical IDs, titles, authors, and abstracts.

Retrieve canonical metadata for one paper ID, such as an arXiv, PMC, PMID, or DOI identifier. Returns the title, abstract, authors, categories, source IDs, and dates as markdown.

Find citation-graph candidates from one to ten `seed_ids`; the first ID is the primary seed and later IDs are anchors. `mode` defaults to `similar` (co-citation/bibliographic coupling); `citers` returns papers citing a seed and `references` papers cited by a seed. `intent` ranks candidates. Returns ranked candidates and the evaluated pool size.

Retrieve in-body passages from one paper that are relevant to a specific question. Full text is available only for indexed papers; `k` controls the number of passages. Returns matching passages or a notice when full text is unavailable.

Search indexed public GitHub issue, pull-request, and README content. Returns ranked matches with repository, URL, snippet, and full matched markdown when available.

For a developer question — code behaviour, a library or framework, an API contract, an error message, or a known bug — search an index built for coding agents. The index covers GitHub issues, merged pull requests, repository READMEs, and curated documentation sites. Set skills to "only" to limit the search to agent-skill files. Returns ranked results with an ID, source type, URL, title, and the matched passages in markdown.

概要

Firecrawl MCP Server とは？

Firecrawl MCP は Firecrawl 公式の Model Context Protocol サーバーです。Claude、Cursor、VS Code などのクライアントから、AI エージェントが Web 検索、ページのクリーンな Markdown や JSON への変換、サイトのクロールとマッピング、ライブページの操作を行えるようにします。

インストール不要のホスト型エンドポイント https://mcp.firecrawl.dev/v2/mcp を使うことも、オープンソースの firecrawl-mcp パッケージを npx や Docker でローカル実行することもできます。ローカルサーバーはセルフホストの Firecrawl インスタンスにも対応しています。

Firecrawl MCP Server の使い方

前提条件： すべてのツールを使うには、https://www.firecrawl.dev/app/api-keys で取得する Firecrawl API キーが必要です。Node.js はローカルの npx インストールでのみ必要です。

ホスト型・キーなし： クライアントを https://mcp.firecrawl.dev/v2/mcp に向けます。キーがない場合、firecrawl_scrape、firecrawl_search、firecrawl_parse がレート制限付きで使えます。クロール、マップ、エージェント系のツールにはキーが必要です。

ホスト型・サインイン： https://mcp.firecrawl.dev/v2/mcp-oauth を使い、クライアント内で OAuth フローを完了します。この URL は MCP エンドポイントであり、ブラウザで開くページではありません。

ホスト型・API キー： URL は https://mcp.firecrawl.dev/v2/mcp のままにして、ヘッダー Authorization: Bearer <FIRECRAWL_API_KEY> を送ります。README では、キーを URL やエージェントとのチャットに入れないよう注意しています。

ローカル：

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

Claude Code

# Hosted with OAuth sign-in
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

# Local server
claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-YOUR_API_KEY -- npx -y firecrawl-mcp

Claude Desktop

claude_desktop_config.json に次を追加します。

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

Cursor

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"
      }
    }
  }
}

VS Code

.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}" }
    }
  }
}

Windsurf

同じ mcpServers ブロック（サーバー名 mcp-server-firecrawl）を ./codeium/windsurf/model_config.json に追加します。

セルフホストする場合は、FIRECRAWL_API_URL に自分のインスタンスを指定します。HTTP_STREAMABLE_SERVER=true を設定すると、ローカルサーバーが Streamable HTTP で http://localhost:3000/mcp から提供されます。Docker イメージは ghcr.io/firecrawl/firecrawl-mcp-server として公開されています。

Firecrawl MCP Server の主な機能

ページ全文を返せる Web 検索と、GitHub の issue、マージ済みプルリクエスト、README、ドキュメントを対象にしたコーディングエージェント向け検索インデックス
任意の URL を Markdown、HTML、リンク、スクリーンショット、または指定したスキーマに沿った JSON として取得
パスフィルター、深さ、ページ数の上限を指定したサイト全体のクロールとマッピング
ライブブラウザ操作：読み取り前にクリック、入力、ページ遷移が可能
非同期のリサーチエージェント、ドキュメント解析（PDF、Word、スプレッドシート）、差分付きの定期ページ監視
クレジット使用量の確認、自動リトライ、レート制限の処理
ホスト型（キーなし、OAuth、API キー）または npx/Docker でのローカル実行。セルフホストの Firecrawl にも対応

Firecrawl MCP Server のツール

フルプロファイルかつデフォルト設定では 27 個のツールが表示されます。キーなしのホスト型エンドポイントでは firecrawl_scrape、firecrawl_search、firecrawl_parse のみが使えます。

取得と解析： firecrawl_scrape は既知の URL を 1 つ読み取り、firecrawl_parse は PDF などのドキュメントを変換します。構造化データの抽出は firecrawl_scrape に formats: ["json"] を指定して行います（firecrawl_extract は非推奨）。
発見： firecrawl_search はクエリから開始し、firecrawl_map は内容を取得せずにサイトの URL を一覧します。
クロール： firecrawl_crawl で複数ページを収集し、firecrawl_check_crawl_status でジョブの進捗を確認します。
操作： firecrawl_interact はライブブラウザセッションを開き、firecrawl_interact_stop で閉じます。
リサーチ： firecrawl_agent と firecrawl_agent_status は複数ソースのリサーチジョブを実行し、firecrawl_research_* ツールは PubMed、bioRxiv、medRxiv、arXiv の論文を検索します。
監視： firecrawl_monitor_* ツールが定期チェックを設定し、変更を報告します。
アカウントとフィードバック： firecrawl_credit_usage、firecrawl_search_feedback、firecrawl_feedback。

Firecrawl MCP Server のユースケース

コーディング中に最新ドキュメントを取り込む：「Scrape the Next.js caching docs and summarize what changed.」
出典付きの調査：「Search for recent benchmarks of vector databases and give me the top five with links.」
構造化データの抽出：「Get the plan names and prices from this pricing page as JSON.」
サイト監査：「Map example.com and list every page under /blog.」
操作しないと表示されないページ：「Open this page, click Load more, then read the results.」
変更の追跡：競合の料金ページにモニターを設定し、変更時に通知を受け取る。

Firecrawl MCP Server と代替ツールの比較

Exa MCP Server と Tavily MCP はエージェント向けの検索に特化し、独自インデックスからコンテンツを返します。一方 Firecrawl MCP は、指定したページのスクレイピング、クロール、操作が中心です。Apify Actors MCP は特定サイト向けの既製スクレイパーを利用できます。スクレイピング API を使わずにシンプルなブラウザ自動化だけが必要なら、Playwright MCP がローカルでブラウザを動かします。

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

ツールが 3 つしか表示されない： キーなしのホスト型エンドポイントを使っています。/v2/mcp-oauth でサインインするか API キーを追加すると、crawl、map、agent などが使えるようになります。
レート制限エラー： サーバーは Firecrawl のレート制限エラーをクライアントに返します。サインインまたは API キーの利用で上限が上がります。クロールでは limit を下げることも有効です。
Windows で Cursor のコマンドが動かない： cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp" を試してください。
OAuth URL をブラウザで開いても何も起きない： これはサーバー URL です。MCP クライアントに追加し、クライアントのアカウント接続フローを使ってください。
クライアントのツール数上限を超える： FIRECRAWL_NO_SEARCH_FEEDBACK=1 や FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 を設定するか、検索専用エンドポイント https://mcp.firecrawl.dev/v2/mcp-search を使います。

よくある質問

Firecrawl MCP は公式ですか？

はい。Firecrawl が `firecrawl/firecrawl-mcp-server` リポジトリ（旧 `mendableai`）で管理しており、@vrknetha による最初のコミュニティ実装へのクレジットも記載されています。

Firecrawl MCP サーバーは無料ですか？

コードは MIT ライセンスで、ホスト型のキーなしプランではアカウントなしでレート制限付きの scrape、search、parse が使えます。その他のツールは Firecrawl プランのクレジットを消費します。最新の料金は firecrawl.dev で確認してください。

どの API キーが必要ですか？

`https://www.firecrawl.dev/app/api-keys` で取得する Firecrawl API キー（`fc-` で始まる）です。ローカルでは `FIRECRAWL_API_KEY` に設定し、ホスト型では Bearer トークンとして送ります。ホスト型では OAuth サインインも使えます。