Firecrawl — веб в читаемом виде для агента

Firecrawl — сервис, который превращает веб-страницу в текст для ИИ-агента: отдаёт Markdown вместо сырого HTML, умеет обходить сайт целиком, строить карту ссылок и искать в вебе. К Claude Code, Codex и Cursor подключается как MCP-сервер по адресу https://mcp.firecrawl.dev/v2/mcp, причём попробовать можно без аккаунта и ключа. Бесплатный план даёт тысячу кредитов в месяц. Проверено по документации 21 августа 2026 года.

Часть 1 · Знакомство

Что такое Firecrawl и какую боль он лечит

Когда агенту дают ссылку, начинается неприятное: страница приходит сырым HTML, где полезный текст перемешан со скриптами, стилями, меню, баннерами и футером. Всё это занимает контекстное окно и сбивает модель. Firecrawl решает узкую задачу: забрать страницу и вернуть её в человекочитаемом виде, по умолчанию в Markdown. Про то, почему за размер контекста вообще стоит бороться, подробнее в гайде про экономию токенов.

Кроме одиночной страницы у сервиса есть обход сайта, карта ссылок, веб-поиск, разбор документов, наблюдение за изменениями и режим интерактива. Репозиторий firecrawl/firecrawl собрал 170 314 звёзд и открыт по AGPL-3.0 — то есть исходники доступны, но лицензия заразная, и это стоит учитывать, если код планируется встраивать в закрытый продукт.

Часть 2 · Подключение

Три способа подключить Firecrawl MCP

Адрес хостового сервера один — https://mcp.firecrawl.dev/v2/mcp. Отличается только способ аутентификации, и от него зависит, сколько инструментов увидит агент.

# Claude Code, вход через браузер (рекомендованный путь)
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

# Claude Code без ключа — просто попробовать
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp

# Codex
codex mcp add firecrawl --url https://mcp.firecrawl.dev/v2/mcp

# Cursor и любой клиент на JSON
{"mcpServers": {"firecrawl": {"url": "https://mcp.firecrawl.dev/v2/mcp"}}}

# OpenCode, файл opencode.json
{"mcp": {"firecrawl": {"type": "remote", "url": "https://mcp.firecrawl.dev/v2/mcp", "enabled": true}}}

После добавления сервера в Claude Code вводят /mcp, выбирают firecrawl и, если выбран браузерный вход, завершают вход в открывшемся окне. Проверка простая: в списке инструментов клиента без ключа видны ровно три позиции — firecrawl_search, firecrawl_scrape и firecrawl_parse. Если инструментов не появилось вовсе, клиент нужно перезапустить. У ChatGPT и Claude, к слову, есть собственный нативный коннектор Firecrawl — там MCP-адрес не нужен.

Часть 3 · CLI

CLI и скилы вместо MCP

У Firecrawl есть второй путь: не сервер с инструментами, а командная строка плюс скилы, которые объясняют агенту, когда и как ей пользоваться. Так работают с Claude Code, Antigravity и OpenCode. Общая механика скилов разобрана в гайде про установку скилов.

# поставить все скилы во все найденные агенты и войти в браузере
npx -y firecrawl-cli@latest init --all --browser

# ручная установка CLI
npm install -g firecrawl-cli

# вход: браузером, ключом или переменной окружения
firecrawl login --browser
firecrawl login --api-key fc-ВАШ-КЛЮЧ
export FIRECRAWL_API_KEY=fc-ВАШ-КЛЮЧ

# состояние: версия, способ входа, параллельность, остаток кредитов
firecrawl --status

# забор страницы без навигации и футеров
firecrawl https://example.com --only-main-content

После установки скилов агента нужно перезапустить, иначе он их не увидит — это отдельно отмечено в документации. Часть команд работает и без входа, по бесплатному режиму с ограничением по IP. Форматы вывода у забора страницы задаются флагом --format: markdown, html, rawHtml, links, screenshot, json, images, summary, changeTracking, attributes, branding, product. Полезные соседи — --wait-for для страниц, которые дорисовываются скриптом, и --format json со схемой, когда нужен не текст, а конкретные поля.

Часть 4 · Свой сервер

Самохостинг: что поднимается и что теряется

Инструкция закреплена на релизе v2.11.162: клон репозитория на этом теге, минимальный .env, docker compose up -d, и API отвечает на http://localhost:3002. Из требований — Git, Docker Engine или Desktop, Docker Compose второй версии и curl для проверки; порт 3002 должен быть свободен. Пароль PostgreSQL документация просит сделать длиной не меньше 32 случайных символов, а имя базы оставить postgres: в этом релизе на неё завязана периодическая задача.

Второй сюрприз — состав возможностей. В открытом варианте работают забор страницы, обход сайта, карта ссылок и поиск: режимы обработки Fetch и Playwright входят в комплект. А вот скриншоты и действия на странице недоступны — оба режима сообщают об отсутствии поддержки, обоим нужен отдельный сервис Fire-engine, который в комплект не входит и настраивается сам по себе. Agent, работа с браузером, интерактив, обратная связь и специализированные форматы остаются облачными. Извлечение через модель требует подключить OpenAI-совместимого провайдера или локальную модель в Ollama.

Свой сервер и CLI связываются флагом --api-url или переменной FIRECRAWL_API_URL. При нестандартном адресе CLI не пытается аутентифицироваться в облаке — что логично для стенда с выключенной проверкой, но означает, что доступ к такому API закрывается снаружи, а не самим Firecrawl.

Часть 5 · Деньги

Кредиты, тарифы и лимиты

Тарифы сверены по странице цен 21 августа 2026 года. Enterprise идёт по договорённости и добавляет безлимит, SLA, нулевое хранение данных и SSO.

Кредиты списываются по операции, и разброс заметный: забор страницы, обход и карта ссылок стоят по одному кредиту за страницу, поиск — два за десять результатов, интерактив — два за минуту работы браузера, наблюдение — один за страницу за каждую проверку. У режима Agent динамическая цена и пять бесплатных запусков в день. Отдельно от кредитов работают лимиты частоты и очереди: превышение любого даёт ответ 429, задача в очереди отваливается максимум через 48 часов, а время ожидания в очереди засчитывается в timeout запроса — поэтому иногда полезнее поставить таймаут поменьше и получить отказ быстро. Счётчики общие на команду: все ключи одной команды делят один лимит.

Вопросы

Частые вопросы

Читать дальше

Соседние гайды