Firecrawl API: парсинг сайтов в JSON и Markdown — разбор возможностей

Firecrawl API в 2026 году от получения ключа до первого запроса

Firecrawl API превращает любую страницу в чистый markdown или структурированный JSON одним запросом, без своих прокси и без ручного парсинга HTML. Обновлено: август 2026. Ниже — пошагово: где взять ключ, как выглядит первый запрос на /scrape, и как через /extract вытащить конкретные поля со страницы, описав их обычным языком.

Firecrawl API даёт доступ к чужим сайтам через один эндпоинт /scrape без ключа для теста и с ключом fc- для рабочих объёмов. Из статьи: получение ключа, код первого запроса, разбор /extract на примере мониторинга цен конкурентов.

Где взять API-ключ Firecrawl?

Ключ создаётся в личном кабинете на firecrawl.dev после регистрации, начинается с префикса fc- и подставляется в заголовок Authorization.

Регистрация занимает пару минут через Google-аккаунт или почту. После входа в панели app/api-keys создаётся ключ вида fc-xxxxxxxx. Бесплатный тариф в 2026 году даёт 1000 кредитов в месяц, карта не нужна, кредиты обновляются каждый месяц заново.

Отдельно: без ключа тоже можно отправить тестовый запрос на /scrape, Firecrawl это разрешает для ознакомления. Но лимиты низкие, и для рабочего проекта ключ всё равно понадобится.

Вот тут упускают важную деталь почти во всех туториалах. Ключ нельзя коммитить в открытый репозиторий и нельзя хардкодить прямо в коде примера. Публичный ключ в открытом доступе за час-два приведёт к тому, что кто-то потратит ваши кредиты за вас. Правильный путь — переменная окружения.

# .env
FIRECRAWL_API_KEY=fc-ваш_ключ_сюда

import os
from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key=os.environ["FIRECRAWL_API_KEY"])

Файл .env сразу добавляем в .gitignore. Если работаете в Claude Code или Cursor, ключ можно положить в переменные окружения сессии, а не вставлять текстом в промпт — агент подхватит его из окружения сам.

Как сделать первый запрос на /scrape?

Минимальный запрос — URL и список форматов вывода. Firecrawl сам рендерит JS, обходит защиту от ботов и возвращает markdown или HTML за секунды.

Один вызов /scrape заменяет связку из headless-браузера, ротации прокси и ручной чистки HTML от рекламы и меню. В 2026 году это и есть главное отличие от классического парсинга: не пишешь скрипт под конкретный сайт, а получаешь готовые данные с любого.

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key=os.environ["FIRECRAWL_API_KEY"])

doc = firecrawl.scrape(
    "https://example.com/blog/post",
    formats=["markdown", "html"]
)

print(doc.markdown[:500])

Ответ приходит в виде объекта с полями markdown, html и metadata. В metadata лежат заголовок страницы, description, дата, статус-код и исходный URL. На практике этого достаточно, чтобы сразу скормить текст в LLM без промежуточной чистки.

{
  "markdown": "# Заголовок статьи\n\nТекст без рекламы и меню...",
  "metadata": {
    "title": "Пример статьи",
    "description": "Короткое описание страницы",
    "statusCode": 200,
    "sourceURL": "https://example.com/blog/post"
  }
}

Если нужно пройти целый раздел документации, а не одну страницу, тот же клиент умеет crawl — рекурсивно обходит подстраницы по ссылкам и возвращает их все уже размеченным markdown. Для одной страницы хватает /scrape, для целого сайта — /crawl.

Что делает /extract и чем он отличается от обычного парсинга?

/extract принимает описание нужных данных на естественном языке и сам находит эти поля в содержимом страницы, возвращая готовый JSON без написания CSS-селекторов.

Раньше для вытаскивания конкретных полей — цены, названия, наличия — писали CSS-селектор под структуру конкретной страницы. Firecrawl v2 предлагает другой путь: описываешь, что нужно, словами, а модель сама находит эти данные в разметке, даже нестандартной.

result = firecrawl.extract(
    urls=["https://shop-example.ru/product/123"],
    prompt="Извлеки название товара, цену в рублях и статус наличия на складе"
)

print(result.data)

{
  "product_name": "Пример товара",
  "price_rub": 4990,
  "in_stock": true
}

Можно задать и жёсткую JSON-схему вместо свободного промпта — тогда поля предсказуемы на 100%, что важно для систем, которые дальше пишут результат в базу данных. Для нестабильной верстки, где схема плавает от страницы к странице, промпт-подход работает надёжнее.

Extract против CSS-селекторов, что выбрать для мониторинга цен?

Для мониторинга цен конкурентов промпт-подход устойчивее к редизайну сайта: селектор ломается при любом изменении вёрстки, а описание смысла остаётся рабочим.

Классический пример — отслеживание цены товара на карточке конкурента. Написал CSS-селектор .price-value, всё работает, пока конкурент не поменяет дизайн сайта. После редизайна селектор перестаёт находить элемент, и скрипт молча возвращает пустоту или падает.

С /extract запрос звучит как "цена товара на странице" — и это работает независимо от того, как называется CSS-класс сегодня и как он будет называться после следующего обновления фронтенда у конкурента. Модель ищет цену по смыслу, а не по разметке.

Есть нюанс: для страниц, где значения намеренно скрыты или требуют логина, ни промпт, ни схема не помогут. Здесь всё ещё нужен /scrape с ручной авторизацией или отдельный подход через Interact, который умеет кликать и заполнять формы перед извлечением.

Ещё практический сценарий — из ролика про подключение Firecrawl к Claude Code: парсинг объявлений на Авито и поиск компаний по нише через связку с AI-агентом. Авито сопротивляется обычному парсингу, а Firecrawl отдаёт чистый markdown, который агент читает без лишнего мусора и тратит на это меньше токенов.

Максим: «Ребят, это работает. У нас портал VibeCoderz на 6 200 материалов собран за неделю тремя скриптами прямо голосом в Claude Code — без единой строчки кода вручную. С парсингом та же логика: не пишешь селектор под каждый сайт, а объясняешь агенту, что нужно достать».

Сколько стоит Firecrawl API в 2026 году?

Бесплатный тариф даёт 1000 кредитов в месяц без карты. Платные тарифы стартуют с $16 в месяц, кредиты не переносятся на следующий период.

Оплата построена на кредитах: 1 кредит примерно равен одной странице в базовом режиме /scrape. Extract и продвинутые режимы съедают больше кредитов за страницу, потому что за них платится ещё и токенами модели.

Важная деталь, которую легко упустить: на стандартных тарифах кредиты не переносятся на следующий месяц, сгорают в конце цикла. Для проектов с неравномерной нагрузкой это стоит учитывать заранее, а не после первого счёта.

Как выглядит связка Firecrawl с Claude Code на практике?

Firecrawl подключается к Claude Code как MCP-сервер, после чего агент сам решает, когда сходить в интернет за данными, без отдельных вызовов API вручную.

MCP — открытый протокол от Anthropic, через который агент получает доступ к внешним инструментам. Firecrawl отдаёт готовый MCP-сервер, и после подключения агент в Claude Code, Cursor или другой AI IDE сам вызывает scrape или extract, когда это нужно по ходу диалога.

На практике это удобно для задач вида "найди мне конкурентов по установке септиков в Петербурге со ссылками и телефонами" — агент сам ищет, скрейпит найденные страницы и складывает результат в таблицу, а разработчик просто читает готовый ответ. Разбор подключения к Claude Code с готовыми инструкциями — отдельная тема, вынесенная в обзор Firecrawl на портале.

Сильные стороны Firecrawl API

• Один вызов вместо инфраструктуры. Не нужно поднимать headless-браузер, крутить прокси и следить за анти-бот защитой — это уже сделано на стороне сервиса.
• LLM-ready вывод из коробки. Markdown приходит уже без меню, рекламы и скриптов, что экономит токены при передаче в модель.
• Устойчивость к редизайну. /extract работает по смыслу, а не по CSS-классам, поэтому не ломается при обновлении вёрстки целевого сайта.
• MCP из коробки. Подключается к Claude Code, Cursor и другим агентам одной строкой конфига, без своего сервера-прослойки.

Слабые стороны Firecrawl API

• Кредиты не переносятся. На тарифах Hobby, Standard и Growth неиспользованные кредиты сгорают каждый месяц — для бурстовой нагрузки это неудобно.
• Extract не бесплатный по токенам. Чем больше страниц и чем сложнее промпт, тем выше расход кредитов — для 500+ страниц в день дешевле считать заранее.
• Не решает задачи с авторизацией. Страницы за логином или с намеренно скрытыми данными /extract не читает — там нужен /scrape с ручной сессией.
• Self-host требует своих ресурсов. Открытый код есть на GitHub, но локальный запуск снимает часть удобства облачного сервиса.

Кому подходит Firecrawl API

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

Нужен ли API-ключ, чтобы попробовать Firecrawl?
Нет, для теста один запрос на /scrape можно отправить и без ключа. Лимиты низкие, для рабочего проекта ключ всё равно понадобится в течение первого дня.

Сколько стоит один запрос на /scrape?
Базовый scrape списывает примерно 1 кредит за страницу. На бесплатном тарифе это 1000 страниц в месяц без оплаты.

Чем /extract отличается от /agent?
/extract работает по заданным URL и находит поля по промпту или схеме. /agent — более новый режим, который сам ищет нужные страницы по запросу, если точный URL заранее неизвестен.

Можно ли использовать Firecrawl без знания Python?
Да, есть CLI-команда и MCP-сервер для подключения к Claude Code или Cursor — тогда запросы делает AI-агент, а не вы вручную пишете код.

Что делать, если сайт блокирует парсинг?
Firecrawl сам обходит часть антибот-защит через свой браузерный стек. Для особо агрессивной защиты есть Stealth Mode, но он расходует больше кредитов за страницу.

Работает ли Firecrawl с российскими сайтами вроде Авито?
Да, в практических примерах Firecrawl успешно парсит объявления на Авито и отдаёт результат в чистом markdown, который можно сразу передать AI-агенту.

Глоссарий

• Кредит — единица оплаты в Firecrawl, примерно равна одному запросу к одной странице в базовом режиме.
• Markdown — упрощённый текстовый формат разметки без HTML-тегов, удобный для передачи в языковые модели.
• MCP (Model Context Protocol) — открытый протокол от Anthropic для подключения внешних инструментов к AI-агентам.
• Промпт-экстракция — способ достать данные со страницы, описав их обычным языком, без CSS-селектора.
• Stealth Mode — режим Firecrawl для обхода усиленной антибот-защиты, стоит дороже по кредитам.

Внутренние ссылки по теме: обзор Firecrawl, кейс автоматизации Wildberries и Ozon, карточка Claude Code в каталоге. Полный список инструментов для вайбкодинга — в каталоге AI-инструментов.

Источники: официальная документация docs.firecrawl.dev, репозиторий firecrawl на GitHub.

Если нужна помощь с встраиванием Firecrawl в конкретный продукт или пайплайн, запишитесь на консультацию к Максиму.

Обновлено: август 2026.