Firecrawl для AI-агентов: как подключить веб-скрапинг через MCP и API
Firecrawl превращает любой сайт в чистый markdown или JSON, который агент читает без парсера. Разбираем два пути подключения — MCP и API, self-host в Docker, официальные тарифы (снято 13.10.2026) с расчётом цены одного кредита и сравнение с Apify.
ГайдВеб-данныеMCP
Уровень СреднийВремя настройки 10–15 минутОбновлено 13.10.2026
Агенту нужен текст страницы, а не HTML с версткой: Firecrawl отдаёт markdown, JSON по схеме или скриншот — и делает это по одному API-вызову. Подключить его к агенту можно за 10 минут: один блок конфига MCP, либо ключ и pip install firecrawl-py. Ниже — оба пути, self-host в Docker, официальные тарифы с расчётом цены кредита (снято 13.10.2026) и разница с Apify.
Что понадобится
Минимум — ничего: у MCP-подключения есть ключевой режим, где работают поиск, скрап и парсинг в пределах дневных лимитов. Для API нужен ключ (fc-...), для self-host — Docker Compose и 2+ ГБ RAM. Python-обёртка ставится одной командой: pip install firecrawl-py.
191K
Звёзд на GitHub
open-source ядро, снято 13.10.2026
150 000+
Компаний-клиентов
по данным вендора
1 000
Кредитов на Free
в месяц, без карты
v2.11.162
Self-host
версия из документации
01Что умеет Firecrawl: эндпоинты и форматы
Firecrawl — не один метод, а набор операций над вебом. Агенту обычно нужны три из них: найти страницы (search, map), прочитать (scrape, parse) и обойти раздел целиком (crawl). Остальные закрывают специфичные сценарии — отслеживание изменений и интерактивные страницы.
Эндпоинт
Что делает
Когда нужен агенту
Scrape
Одна страница → markdown, JSON, скриншот
Прочитать конкретный URL или прайс
Crawl
Обход сайта или раздела по ссылкам
Собрать документацию, каталог, блог
Map
Быстрый список URL сайта без чтения содержимого
Сначала карта, потом точечный скрап
Search
веб-поиск + контент
Ответить на вопрос по свежим данным
Parse
Файл (PDF, документ) → markdown
Разобрать вложенные документы
Monitor
Отслеживание изменений страницы
Алерты о правках конкурентов и цен
Interact
Скрап, затем действия на странице по промпту
Формы, кнопки, авторизованные сценарии
Agent
Задача на естественном языке → данные
Неизвестная структура источника
Полный список операций сверяйте в документации: вендор добавляет эндпоинты между релизами.
Что происходит с одной страницей
Почему это экономит токены
Сырая страница интернет-магазина легко занимает 300–600 КБ HTML, где полезного текста — единицы процентов. Markdown-выдача того же URL обычно укладывается в несколько килобайт, поэтому один и тот же контекст агента вмещает в разы больше страниц.
02Вариант 1: MCP без единой строки кода
Самый быстрый путь — подключить MCP-сервер. У вендора три режима авторизации, и они ведут к одному набору инструментов: ключевой доступ, вход через браузер (OAuth) и API-ключ. Выбирайте по ситуации: оценить инструмент — ключевой режим, командная работа — вход, автоматизация на сервере — ключ.
Режим
Что даёт
Ограничение
Без ключа
search, scrape, parse
Дневные лимиты, без аккаунта
Вход через браузер
Полный набор инструментов плана
Нужен GUI для подтверждения
API-ключ
Полный набор, удобно на сервере
Ключ в конфиге клиента — храните вне репозитория
Все три режима описаны на официальной странице MCP-сервера; инструменты одинаковые, различается способ авторизации.
Вставьте JSON выше в настройки MCP-клиента и перезапустите его. Для клиентов без поддержки удалённого MCP сервер поднимают локально — команда есть в документации.
Попросите агента прочитать короткую страницу и вернуть заголовок: так вы увидите, что инструменты видны и авторизация прошла.
terminalcopy
scrape https://example.com
3
Поставьте лимит
Кредиты расходуются на каждый вызов: наведите порядок в промпте агента — сначала map или search, потом точечный скрап нужных URL.
terminalcopy
map → search → scrape
03Вариант 2: API и SDK для своего сервиса
Если данные собирает ваш бэкенд, а не чат-агент, берите SDK. Официальные клиенты есть для Python и Node.js, плюс CLI для терминала. Минимальный сценарий — поиск и скрап в несколько строк: ключ передаётся в конструктор клиента, ответ приходит объектом с полем markdown или json.
scrape.pypython
from firecrawl import Firecrawl
app = Firecrawl(api_key="fc-YOUR-API-KEY")
pages = app.search("firecrawl web scraping", limit=5)
for hit in pages.web:
print(hit.title, hit.url)
doc = app.scrape("https://example.com", formats=["markdown"])
print(doc.markdown[:400])
Как выбрать транспорт
Практика, которая экономит кредиты
Сначала map или search — потом scrape только нужных URL. Проверка «сколько всего страниц» обходится дешевле, чем полный crawl раздела, а результат агент получает тот же. И ставьте таймауты: длинный обход с ретраями съедает кредиты быстрее, чем ошибка в промпте.
04Self-host: свой стек в Docker
Ядро Firecrawl открыто под AGPL-3.0, поэтому стек можно поднять у себя: документация описывает установку через Docker Compose с зафиксированным релизом v2.11.162, API поднимается на http://localhost:3002. Важно понимать, что это режим для доверенной сети: в базовой инструкции аутентификация отключена, а часть облачных возможностей (антибот-прокси, часть эндпоинтов) недоступна.
Локальный запуск
1
Склонируйте релиз
Возьмите тег из документации, а не ветку main: сборка из непроверенного кода на своей инфраструктуре — отдельный риск.
Docker Compose поднимает API, воркеры и вспомогательные сервисы (Redis, база). Требования к железу смотрите в README репозитория.
terminalcopy
docker compose up -d
3
Проверьте доступность
Smoke-тест — обычный POST на /v2/scrape с любым URL: ответ должен содержать markdown.
terminalcopy
curl -s http://localhost:3002/v2/scrape
4
Закройте наружу
Перед продакшеном включите аутентификацию, TLS и постоянное хранилище — базовая инструкция этого не делает.
terminalcopy
docs.firecrawl.dev/contributing/self-host
Критерий
Firecrawl Cloud
Self-host
Прокси и антибот
есть
нет — решаете сами
Эндпоинты
полный набор
часть недоступна
Данные
уходят вендору
остаются у вас
Стоимость
по кредитам
своё железо и поддержка
Обновления
автоматически
вручную, по тегам
Self-host выбирают ради данных в своём контуре, а не ради экономии: поддержка стека ложится на вас.
05Тарифы Firecrawl и реальная цена кредита
Подписка измеряется кредитами: поисковый вызов дороже скрапа. В тарифах вендора указано, что 1 000 кредитов — это примерно 500 поисков или 1 000 прочитанных страниц. Цифры ниже сняты с официальной страницы тарифов 13.10.2026 (при годовой оплате — скидка).
Free
$0для оценки
1 000 кредитов в месяц
500 поисков или 1 000 страниц
2 параллельных запроса
Низкие лимиты частоты
Hobby
$16в месяц при годовой оплате
5 000 кредитов
5 параллельных запросов
Базовая поддержка
+1 000 кредитов за $5
оптимально
Standard
$83в месяц при годовой оплате
100 000 кредитов
25 параллельных запросов
Поддержка Standard
+2 000 кредитов за $5
Growth
$333в месяц при годовой оплате
500 000 кредитов
Больше параллельных запросов
Для высоких объёмов
Скидка за объём
Официальный прайс Firecrawl (снято 13.10.2026). Цены и лимиты меняются — перед покупкой сверяйтесь с первоисточником.
Отдельно есть план Scale на 1 млн кредитов и корпоративные условия — детали на странице тарифов.
Кредитов в месяц по тарифамкредиты, логарифмическая шкала восприятия
Разница между Free и Growth — в 500 раз. Официальные данные, снято 13.10.2026.
Цена 1 000 кредитов по тарифамценты — расчёт из официальных цен: месячная плата ÷ кредиты × 1 000
Считается по прайсу: $16 ÷ 5 000 × 1 000 = $3,20 (320¢); $83 ÷ 100 000 × 1 000 = $0,83 (83¢); $333 ÷ 500 000 × 1 000 = $0,67 (67¢). Free в расчёт не входит: кредиты выдаются без оплаты.
06Firecrawl или Apify: что выбрать агенту
Оба сервиса закрывают задачу «дать агенту веб-данные», но с разных сторон. Firecrawl — единый API чтения: любая страница превращается в markdown или JSON по схеме, оплата кредитами, никакой возни с прокси. Apify — маркетплейс готовых акторов: если под источник уже написан парсер (карты, маркетплейсы, соцсети), вы за минуты получаете структурированные поля, но платите за compute units и прокси по факту использования.
Критерий
Firecrawl
Apify
Единица оплаты
кредиты
compute unit + прокси
Готовые парсеры под источники
нет — только чтение
86 594 актора в Store
Self-host ядра
AGPL-3.0
Apache-2.0 (Crawlee), платформа — облако
Бесплатный вход
1 000 кредитов в месяц
$0 и $5 кредита
Порог входа
конфиг MCP за 10 минут
выбор актора и расчёт CU
Стратегия «оба сразу» тоже рабочая: Firecrawl читает произвольные страницы, Apify добирает источники со сложной антибот-защитой.
Как менялся проект за два года
Частые вопросы
Firecrawl что это простыми словами?
Сервис, который превращает веб-страницы в чистый текст или JSON, понятный языковой модели. Вместо парсинга HTML вы делаете один вызов и получаете markdown: агент экономит контекст, а разработчик — время на разбор верстки.
Сколько стоит Firecrawl в 2026 году?
По официальному прайсу на 13.10.2026: Free — $0 и 1 000 кредитов в месяц, Hobby — $16, Standard — $83, Growth — $333 при годовой оплате. В пересчёте на 1 000 кредитов это $3,20, $0,83 и $0,67 соответственно. Цены и лимиты обновляются — сверяйтесь со страницей тарифов.
Можно ли пользоваться Firecrawl бесплатно?
Да: бесплатный план даёт 1 000 кредитов в месяц без карты, а MCP-подключение поддерживает ключевой режим, где доступны поиск, скрап и парсинг в пределах дневных лимитов. Если нужен полностью свой контур — поднимайте self-host: ядро открыто под AGPL-3.0.
Как подключить Firecrawl к Claude Code или Cursor?
Через MCP: добавьте в конфиг клиента сервер https://mcp.firecrawl.dev/v2/mcp-oauth и подтвердите вход в браузере, либо используйте URL с API-ключом для серверных сценариев. Для ChatGPT, Codex, Claude и Cursor у вендора есть готовые коннекторы в один клик.
Firecrawl или Apify для агента?
Firecrawl выигрывает, когда нужно читать произвольные страницы и платить по кредитам; Apify — когда под источник есть готовый актор и важны структурированные поля. Часто берут оба инструмента и разводят их по задачам внутри одного агента.
Это законно — скрапить любые сайты?
Техническая возможность не равна праву: смотрите правила сайта, robots.txt и условия сервиса, а персональные данные не собирайте без основания. Для нагруженных источников выбирайте официальные API — это ещё и стабильнее.
Firecrawl — самый короткий путь от URL до чистого текста в контексте агента: MCP-конфиг занимает три строки, ключевой режим позволяет попробовать инструменты без карты, а API и self-host закрывают серверные и закрытые сценарии. Считайте не цену плана, а цену 1 000 кредитов под свой объём: на годовом Standard это $0,83 — дешевле, чем поднимать и обслуживать свой скрапинг ради того же результата.
Собираете агента, который читает веб?
В каталоге Qantcore — обзоры агентов и инструментов веб-данных с единой методикой оценки, фильтрами и сравнением.