convez.ai
MCP ServerIntegração & APIsIntermediário
DaisukeHori

Firecrawl MCP Server

DaisukeHori/firecrawl-mcp

Acesse Firecrawl auto-hospedado do Claude via MCP com 11 ferramentas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 dias
Versão
—
Issues abertas
11
Contribuidores
3

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 で操作する。

Deploy with Vercel License: MIT Tools

LP: daisukehori.github.io/firecrawl-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_searchWeb検索。結果のMarkdown取得も可能
firecrawl_mapサイトの全URL一覧を取得(sitemap + リンク探索)
firecrawl_extractLLMでページから構造化データ(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 サーバーに設定する前に、以下が必須です。

項目説明
公開 URLVercel から到達可能な https://...
API キーFirecrawl で認証が不要なら空欄可
HTTPSVercel から HTTP を呼ぶと Mixed Content 等で失敗する可能性があります

確認コマンド:

curl https://your-firecrawl.example.com/test

ステップ2: MCP サーバーをデプロイ

ワンクリックデプロイ(推奨)

Deploy with Vercel

手動デプロイ

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

ライセンス

MIT License


関連 MCP サーバー

堀が公開している MCP サーバー群。すべて Claude.ai / Cursor / ChatGPT 等の MCP クライアントから利用可能。

サーバーツール数説明
b2cloud-api14ヤマト B2クラウド送り状発行 API/MCP
cloudflare-mcp69Cloudflare 統合(Tunnel/DNS/Workers/Pages/R2/KV/SSL/Access)
hubspot-ma-mcp128HubSpot MA(CRM/Marketing/Knowledge Store)
msgraph-mcp-server48Microsoft Graph API(Exchange/Teams/OneDrive/SharePoint)
playwright-devtools-mcp57Playwright + Chrome DevTools(ブラウザ自動化)
proxmox-mcp-server35Proxmox VE 仮想化基盤操作
printer-mcp-server—CUPS ネットワークプリンタ制御(Kyocera TASKalfa)
yamato-printer-mcp-server—ヤマト送り状サーマルプリンタ(ラズパイ + WS-420B)
ssh-mcp-server10SSH クライアント(セッション管理/非同期コマンド)
mac-remote-mcp34macOS リモート制御(Shell/GUI/ファイル/アプリ)
gemini-image-mcp4Gemini/Imagen 画像生成
runpod-mcp36RunPod GPU FaaS(Pods/Endpoints/Jobs)
firecrawl-mcp ← 今ここ—Firecrawl セルフホスト Web スクレイピング
ad-ops-mcp62広告運用自動化(Google Ads/Meta/GBP/X)
Ver o original no GitHub

Bom para

Relacionados