Firecrawl MCP Server
DaisukeHori/firecrawl-mcp
Acesse Firecrawl auto-hospedado do Claude via MCP com 11 ferramentas
Ver no GitHubServidor MCP que conecta Claude ao Firecrawl auto-hospedado, permitindo web scraping, crawling de sites, buscas e extração estruturada de dados via protocolo MCP. Implementa 11 ferramentas para operações de scraping único/batch, crawling completo de sites, mapeamento de URLs e extração de dados com LLM.
Instalação
npx convez-ai DaisukeHori/firecrawl-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Scraping de páginas web individuais ou em lote via Claude
- Crawling completo de sites e mapeamento de estrutura URL
- Extração estruturada de dados JSON de páginas web
- Automação de coleta de dados integrada ao fluxo Claude
Veredito

Solução técnica bem arquitetada para integrar Firecrawl auto-hospedado ao Claude via MCP. Oferece cobertura completa de operações web (scraping, crawling, extração) com bom suporte de documentação e deploy facilitado em Vercel. Requer infraestrutura mínima de Firecrawl rodando com URL pública.
README
A tradução para o português deste README ainda está na fila.
🔥 Firecrawl MCP Server
セルフホスト Firecrawl を Claude から MCP で操作する。
セルフホストの Firecrawl を MCP (Model Context Protocol) 経由で Claude.ai / Claude Desktop / Claude Code から直接操作できます。
Web検索・単一/バッチスクレイピング・サイトクロール・サイトマップ取得・LLM構造化抽出の11ツールを搭載。
アーキテクチャ
Claude.ai ──MCP──▶ Vercel (firecrawl-mcp)
│
▼
Firecrawl (self-hosted)
your-firecrawl.example.com
Vercel上のNext.jsアプリがMCPプロトコルを処理し、セルフホストFirecrawlのAPIに中継します。サーバーはステートレスで、データの保存やログ出力は行いません。
ツール一覧(11ツール)
スクレイピング
| ツール | 説明 |
|---|---|
firecrawl_scrape | 単一URLをスクレイピング。Markdown/HTML/リンク/スクリーンショット対応 |
firecrawl_batch_scrape | 複数URLを並列スクレイピング(start/status) |
firecrawl_batch_cancel | 実行中のバッチジョブをキャンセル |
firecrawl_batch_errors | バッチジョブのエラー詳細を取得 |
クロール
| ツール | 説明 |
|---|---|
firecrawl_crawl | サイト全体のクロールジョブを開始 |
firecrawl_crawl_status | クロールの進捗・結果取得 / キャンセル |
firecrawl_crawl_errors | クロールジョブのエラー詳細を取得 |
firecrawl_crawl_active | 実行中のクロールジョブ一覧 |
検索・マッピング・抽出
| ツール | 説明 |
|---|---|
firecrawl_search | Web検索。結果のMarkdown取得も可能 |
firecrawl_map | サイトの全URL一覧を取得(sitemap + リンク探索) |
firecrawl_extract | LLMでページから構造化データ(JSON)を抽出 |
クイックスタート(4ステップ)
ステップ1: セルフホスト Firecrawl を用意
Firecrawl セルフホストガイド に従ってFirecrawlを起動します。
git clone https://github.com/mendableai/firecrawl.git
cd firecrawl
docker compose up -d
デフォルトで http://localhost:3002 で起動します。
⚠️ 重要:
http://localhost:3002のままでは、Vercel 上の MCP サーバーから接続できません。次の「ステップ1.5」を必ず実行してください。
ステップ1.5: Firecrawl を MCP サーバーから到達可能にする
Vercel 上の MCP サーバーはインターネット越しに Firecrawl API を呼び出します。そのため、ローカルホストのままでは接続できず、公開 URL(HTTPS 推奨)が必要です。
以下のいずれかの方法で公開 URL を用意してください。
A. クラウドサーバー / VPS にデプロイする(本番向け)
EC2、DigitalOcean、Hetzner などに Firecrawl を起動し、ドメインまたはパブリック IP を割り当てます。
# Firecrawl 側 .env の例
HOST=0.0.0.0
PORT=3002
USE_DB_AUTHENTICATION=false
BULL_AUTH_KEY=your-strong-password
Let's Encrypt などで HTTPS 化し、以下のように到達確認します。
curl https://firecrawl.yourdomain.com/test
B. Cloudflare Tunnel でローカル Firecrawl を公開する(開発・検証向け)
ローカルマシンで動いている Firecrawl を、安全にインターネットに公開できます。
cloudflared tunnel --url http://localhost:3002
出力された https://xxxxx.trycloudflare.com を FIRECRAWL_API_URL に設定します。
C. ngrok で一時的に公開する(開発・検証向け)
ngrok http 3002
出力された https://xxxxx.ngrok-free.app を使用します。
接続情報の確認
MCP サーバーに設定する前に、以下が必須です。
| 項目 | 説明 |
|---|---|
| 公開 URL | Vercel から到達可能な https://... |
| API キー | Firecrawl で認証が不要なら空欄可 |
| HTTPS | Vercel から HTTP を呼ぶと Mixed Content 等で失敗する可能性があります |
確認コマンド:
curl https://your-firecrawl.example.com/test
ステップ2: MCP サーバーをデプロイ
ワンクリックデプロイ(推奨)
手動デプロイ
git clone https://github.com/DaisukeHori/firecrawl-mcp.git
cd firecrawl-mcp
cp .env.example .env.local
# .env.local を編集
npm install
npm run dev
ステップ3: Claude から接続
Claude.ai(Web): Settings → MCP → Add:
- URL:
https://your-firecrawl-mcp.vercel.app/api/mcp - Header名:
x-api-key値:あなたのMCP_API_KEY
Claude Desktop / Cursor / VS Code / Windsurf:
{
"mcpServers": {
"firecrawl": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://your-firecrawl-mcp.vercel.app/api/mcp"],
"env": {
"HEADER_x-api-key": "あなたのMCP_API_KEY"
}
}
}
}
Claude Code:
claude mcp add --transport http firecrawl https://your-firecrawl-mcp.vercel.app/api/mcp \
--header "x-api-key: あなたのMCP_API_KEY"
環境変数
| 変数 | 必須 | 説明 |
|---|---|---|
FIRECRAWL_API_URL | ✅ | セルフホスト Firecrawl の URL(例: https://firecrawl.example.com)。末尾の / は不要です。 |
FIRECRAWL_API_KEY | △ | Firecrawl API キー(USE_DB_AUTHENTICATION=false のセルフホストでは不要) |
MCP_API_KEY | ✅ | MCP サーバーへのアクセスを制限する認証キー |
使用例
ユーザー: 「docs.firecrawl.dev の全ページをMarkdownで取得して」
AI: まずサイトマップを確認します。
[firecrawl_map] → 47ページ検出
クロールジョブを開始します。
[firecrawl_crawl] → ジョブID: abc-123
... ステータス確認中 ...
✅ 47ページ全て取得完了しました。
ユーザー: 「この3つのURLから商品名と価格を抽出して」
AI: [firecrawl_extract]
✅ 構造化データ:
{"name": "Product A", "price": 2980}
{"name": "Product B", "price": 4980}
{"name": "Product C", "price": 7980}
🔒 セキュリティ
- 通信は全て HTTPS(TLS暗号化) で保護
- サーバーは ステートレス。Firecrawl URLやAPIキーはVercel環境変数に保存され、リクエスト中にのみ使用
- サーバーにデータベースなし。Firecrawl APIへのプロキシとして動作するだけ
- ソースコードは 全て公開
MCP_API_KEYで不正アクセスを防止
FAQ
Q: Vercel デプロイ後、FIRECRAWL_API_URL=http://localhost:3002 で動かない
→ localhost は Vercel 上のサーバーから到達できません。Cloudflare Tunnel や自前サーバーの公開 URL を使用してください。詳細はステップ1.5を参照してください。
Q: Firecrawl サーバーに接続できません と表示される
→ Firecrawl 側の .env で HOST=0.0.0.0 になっているか、ファイアウォール・ポートが開いているか確認してください。
Q: Firecrawlクラウド版でも使える?
→ はい。FIRECRAWL_API_URL=https://api.firecrawl.dev に設定し、FIRECRAWL_API_KEY にクラウドのAPIキーを入れてください。
Q: extract ツールが動かない
→ セルフホスト版では OPENAI_API_KEY 等のLLM設定がFirecrawl側に必要です。セルフホストガイドを確認してください。
Q: バッチスクレイプ/クロールのステータスが scraping のまま
→ セルフホスト版ではステータス遷移に数秒のラグがあります。2〜3回ポーリングすると completed になります。これは既知の動作です。
Q: Firecrawlのどのバージョンが必要?
→ v1 API(/v1/エンドポイント)対応版。Docker Composeで最新版を使えば問題ありません。
Q: HubSpot MA MCPとの違いは? → HubSpot MA MCPはHubSpot CRM/MA操作用(128ツール)。Firecrawl MCPはWebスクレイピング/クロール用(11ツール)。用途が異なるため併用できます。
技術スタック
Next.js 15 / TypeScript / MCP SDK / Vercel / Zod
ライセンス
関連 MCP サーバー
堀が公開している MCP サーバー群。すべて Claude.ai / Cursor / ChatGPT 等の MCP クライアントから利用可能。
| サーバー | ツール数 | 説明 |
|---|---|---|
| b2cloud-api | 14 | ヤマト B2クラウド送り状発行 API/MCP |
| cloudflare-mcp | 69 | Cloudflare 統合(Tunnel/DNS/Workers/Pages/R2/KV/SSL/Access) |
| hubspot-ma-mcp | 128 | HubSpot MA(CRM/Marketing/Knowledge Store) |
| msgraph-mcp-server | 48 | Microsoft Graph API(Exchange/Teams/OneDrive/SharePoint) |
| playwright-devtools-mcp | 57 | Playwright + Chrome DevTools(ブラウザ自動化) |
| proxmox-mcp-server | 35 | Proxmox VE 仮想化基盤操作 |
| printer-mcp-server | — | CUPS ネットワークプリンタ制御(Kyocera TASKalfa) |
| yamato-printer-mcp-server | — | ヤマト送り状サーマルプリンタ(ラズパイ + WS-420B) |
| ssh-mcp-server | 10 | SSH クライアント(セッション管理/非同期コマンド) |
| mac-remote-mcp | 34 | macOS リモート制御(Shell/GUI/ファイル/アプリ) |
| gemini-image-mcp | 4 | Gemini/Imagen 画像生成 |
| runpod-mcp | 36 | RunPod GPU FaaS(Pods/Endpoints/Jobs) |
| firecrawl-mcp ← 今ここ | — | Firecrawl セルフホスト Web スクレイピング |
| ad-ops-mcp | 62 | 広告運用自動化(Google Ads/Meta/GBP/X) |