Firecrawl MCP Server

Что умеет сервер

Сервер подключает к MCP-клиенту сервис Firecrawl. Инструмент firecrawl_scrape превращает один адрес в чистый Markdown или в JSON по заданной вами схеме, firecrawl_map собирает список адресов сайта без загрузки содержимого, firecrawl_crawl забирает текст со многих страниц, firecrawl_search ищет в вебе, а firecrawl_parse разбирает PDF и другие документы. Кроме того, есть поиск по разработческим источникам (issues, pull request, README, документация), по документам американских госорганов и по научным статьям.

Более сложные сценарии: firecrawl_interact кликает, вводит текст и заполняет формы на динамических страницах, агентные задачи собирают структурированные данные из нескольких источников, а инструменты firecrawl_monitor_* следят за страницами и присылают изменения. Полный профиль включает 27 инструментов, поддерживаются облако и собственный сервер.

Когда использовать

В README есть подсказка по выбору. Известен адрес и нужен текст: firecrawl_scrape, лучше с JSON-схемой, чтобы не раздувать контекст. Нужно найти страницы сайта: firecrawl_map. Нужен контент многих страниц: firecrawl_crawl, обязательно с ограничениями (limit, includePaths, excludePaths, maxDiscoveryDepth). Адреса неизвестны: firecrawl_search.

Не подходит для долгих сценариев, где вы сами управляете браузерной сессией по шагам: каждый вызов firecrawl_interact выполняет один запрос до конца и возвращает управление.

Ограничения и безопасность

Для большинства инструментов нужен ключ Firecrawl, а расход идёт в кредитах. Например, поиск стоит 2 кредита, а параметр scrapeOptions дополнительно загружает каждую найденную страницу и оплачивается как отдельный скрейпинг. Бесплатный публичный адрес без ключа ограничен по скорости и открывает только три инструмента: firecrawl_scrape, firecrawl_search и firecrawl_parse. Остальные, в том числе crawl, map и agent, требуют ключ.

Ключ нельзя указывать в адресе сервера и тем более писать в чат с агентом: его задают в защищённом заголовке или секрете клиента. При запуске в Docker порт стоит публиковать только на 127.0.0.1, иначе любой, кто достучится до порта, воспользуется вашим ключом. Сервис читает чужие страницы, поэтому текст оттуда нельзя считать надёжной инструкцией для агента. Код выпущен по лицензии MIT.

Облачный сервер без установки

Бесплатный вариант без ключа (только scrape, search, parse, с ограничением скорости):

https://mcp.firecrawl.dev/v2/mcp

Для подключения к аккаунту используйте адрес https://mcp.firecrawl.dev/v2/mcp-oauth. Для доступа по ключу оставьте адрес https://mcp.firecrawl.dev/v2/mcp и добавьте в настройках клиента заголовок:

Authorization: Bearer <FIRECRAWL_API_KEY>

Запуск через npx

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

Глобальная установка:

npm install -g 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 (версия 0.48.6)

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

Windsurf

Файл ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "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}"
      }
    }
  }
}

Docker

docker run -i --rm -e FIRECRAWL_API_KEY=fc-YOUR_API_KEY ghcr.io/firecrawl/firecrawl-mcp-server:latest

Режим Streamable HTTP на http://localhost:3000/mcp:

docker run --rm -p 127.0.0.1:3000:3000 \
  -e HTTP_STREAMABLE_SERVER=true \
  -e FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
  ghcr.io/firecrawl/firecrawl-mcp-server:latest

Для собственного сервера Firecrawl задайте переменную FIRECRAWL_API_URL.