🔥 Firecrawl MCP Server

Управление self-hosted Firecrawl из Claude через MCP.

LP: daisukehori.github.io/firecrawl-mcp

Вы можете напрямую управлять self-hosted Firecrawl из Claude.ai / Claude Desktop / Claude Code через MCP (Model Context Protocol).

Включает 11 инструментов для веб-поиска, одиночного/пакетного парсинга, обхода сайтов, получения карты сайта и структурированного извлечения данных с помощью LLM.

Архитектура

Claude.ai ──MCP──▶ Vercel (firecrawl-mcp)
                        │
                        ▼
               Firecrawl (self-hosted)
               your-firecrawl.example.com

Приложение Next.js на Vercel обрабатывает протокол MCP и перенаправляет запросы к API вашего self-hosted Firecrawl. Сервер является stateless (без сохранения состояния), не сохраняет данные и не ведет логи.

Related MCP server: Firecrawl MCP Server

Список инструментов (11 инструментов)

Парсинг

Обход (Crawl)

Поиск, маппинг и извлечение

Быстрый старт (3 шага)

Шаг 1: Подготовьте self-hosted Firecrawl

Запустите Firecrawl, следуя руководству по self-hosting Firecrawl.

git clone https://github.com/mendableai/firecrawl.git
cd firecrawl
docker compose up -d

По умолчанию он запускается на http://localhost:3002.

Шаг 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

• Имя заголовка: 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"

Переменные окружения

Примеры использования

ユーザー: 「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-шифрование)

• Сервер stateless. URL Firecrawl и API-ключи сохраняются в переменных окружения Vercel и используются только во время запроса

• На сервере нет базы данных. Он работает только как прокси к API Firecrawl

• Исходный код полностью открыт

• MCP_API_KEY предотвращает несанкционированный доступ

FAQ

В: Можно ли использовать облачную версию Firecrawl? → Да. Установите FIRECRAWL_API_URL=https://api.firecrawl.dev и укажите облачный API-ключ в FIRECRAWL_API_KEY.

В: Инструмент extract не работает → В self-hosted версии Firecrawl требуются настройки LLM (например, OPENAI_API_KEY). Проверьте руководство по self-hosting.

В: Статус пакетного парсинга/обхода завис на scraping → В self-hosted версии есть задержка в несколько секунд при смене статуса. После 2-3 опросов статус изменится на completed. Это известное поведение.

В: Какая версия Firecrawl нужна? → Версия с поддержкой API v1 (эндпоинт /v1/). Если вы используете последнюю версию через Docker Compose, проблем не будет.

В: В чем отличие от HubSpot MA MCP? → HubSpot MA MCP предназначен для работы с HubSpot CRM/MA (128 инструментов). Firecrawl MCP предназначен для веб-парсинга/обхода (11 инструментов). Они имеют разное назначение и могут использоваться вместе.

Технологический стек

Next.js 15 / TypeScript / MCP SDK / Vercel / Zod

Лицензия

MIT License

Связанные MCP-серверы

Список MCP-серверов, опубликованных Hori. Все они доступны для использования из MCP-клиентов, таких как Claude.ai / Cursor / ChatGPT и др.