Vrknetha MCP Server Firecrawl

🚀 FireCrawl MCP サーバ

FireCrawl と統合された Model Context Protocol (MCP) サーバの実装で、高度なウェブクローリング機能を提供します。

🚀 クイックスタート

FireCrawl MCP サーバは、高度なウェブクローリング機能を提供するために FireCrawl と統合された MCP サーバの実装です。以下の手順で始めることができます。

✨ 主な機能

• JavaScript レンダリング：JavaScript が多用されたウェブサイトからコンテンツを抽出します。
• モバイル/デスクトップビュー：さまざまなビューポート設定をサポートします。
• スマートなレート制限：組み込みのレート制限処理機能があります。
• 複数のフォーマット：HTML、Markdown、スクリーンショット、純テキストの抽出をサポートします。
• バッチ処理：複数の URL を効率的に処理します。
• コンテンツフィルタリング：特定の HTML タグを含めたり除外したりできます。

📦 インストール

npm install mcp-server-firecrawl

📚 ドキュメント

ツール

fire_crawl_scrape

単一の URL からコンテンツをクロールし、カスタムオプションを使用できます。

• 入力:
  • url (文字列)：クロールする対象の URL
  • formats (配列)：出力形式 (markdown, html, rawHtml, screenshot, links, screenshot@fullPage, extract)
  • waitFor (数値、オプション)：待機時間（ミリ秒）
  • onlyMainContent (ブール値、オプション)：主要なコンテンツのみを抽出する
  • includeTags (配列、オプション)：特別に含める HTML タグ
  • excludeTags (配列、オプション)：除外する HTML タグ
  • mobile (ブール値、オプション)：モバイルビューを使用する
  • skipTlsVerification (ブール値、オプション)：TLS 検証をスキップする

fire_crawl_batch

複数の URL のバッチクロールジョブを開始します。

• 入力:
  • urls (配列)：クロールする URL のリスト
  • formats (配列)：出力形式（単一のクロールと同じ）
  • その他のオプションは fire_crawl_scrape と同じです。

fire_crawl_status

バッチクロールジョブの状態を確認します。

• 入力:
  • id (文字列)：確認するバッチジョブの ID

設定

API キーの取得

1. FireCrawl アカウント で登録します。
2. ダッシュボードから API キーを生成します。
3. API キーを環境変数に設定します。

Claude Desktop の使用

claude_desktop_config.json に以下の内容を追加します。

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

開発

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

# ビルド
npm run build

# テストの実行
npm test

レート制限

• 無料プラン：1 分間に 3 回のリクエスト
• レート制限に達した後は 25 秒のクールダウン時間が必要です。
• 有料プランではより高い制限が利用可能です。

📄 ライセンス

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