3 сентября 20268 мин чтения

MCP: Firecrawl в Claude Code (поиск и скрапинг веб-страниц)

Firecrawl — это сервис, который даёт Claude Code доступ к вебу: искать в интернете, «вытаскивать» текст со страниц (скрапинг). Поддерживает извлечение данных со сложных страниц.

Евгений Васёв

Автор гайда

Firecrawl в

Claude Code: поиск и скрапинг веба

Firecrawl — это сервис, который даёт Claude Code доступ к вебу: искать в интернете, «вытаскивать» текст со страниц (скрапинг) и находить документацию. Claude сможет сам искать актуальную информацию и читать сайты по твоей просьбе — например: «Найди последние фичи Next.js 16» или «Прочитай страницу firecrawl.dev и расскажи, что это за сервис». Чем Firecrawl отличается от встроенных в Claude Code web_search и web_fetch, описано в разделе Чем Firecrawl отличается от встроенных web_search и web_fetch.

Чтобы подключить Firecrawl, нужны: аккаунт на Firecrawl (бесплатный), API-ключ и одна команда в терминале. Ниже — пошаговая инструкция.

Нужен Node.js: Firecrawl MCP запускается через
npx. Если у тебя ещё не установлен Node.js, сначала пройди
гайд [07-nodejs](../07-nodejs/guide.md), затем возвращайся
сюда.

Ниже две инструкции — выбери свою систему: macOS или Windows.

---

macOS

1.

Зарегистрируйся на Firecrawl и получи API-ключ

Открой в браузере: https://firecrawl.dev/app
Нажми Sign up (или Log in, если

уже есть аккаунт) и войди через Google или email.

После входа открой раздел с API-ключом (обычно **API

Keys или Settings → API**).

Нажми Create API Key (или **Copy API

Key**, если ключ уже есть).

Скопируй ключ и сохрани его в надёжное место (блокнот, менеджер

паролей). Он понадобится в следующем шаге.

Важно: Ключ показывают один раз. Если потеряешь —
придётся создать новый в кабинете Firecrawl.

---

2. Открой Терминал

Способ 1 — через поиск (самый быстрый):

Нажми Cmd + Пробел
Напиши Terminal
Нажми Enter

Способ 2 — через Finder:

Открой Finder
Меню Переход → Утилиты
Открой Terminal

---

3. Добавь Firecrawl MCP в

Claude Code

В терминале выполни команду, подставив свой API-ключ вместо your-api-key:

claude mcp add firecrawl -e FIRECRAWL_API_KEY=your-api-key -- npx -y firecrawl-mcp

Как подставить ключ:

Выдели your-api-key в команде выше и замени на свой

ключ (без кавычек и пробелов), или

Скопируй команду целиком, вставь в терминал, затем замени

your-api-key на свой ключ (Cmd + V для вставки).

Пример (ключ условный):

claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-abc123xyz -- npx -y firecrawl-mcp

Нажми Enter.

---

4. Дождись окончания установки

Появится сообщение о добавлении MCP-сервера. Дождись, пока команда завершится (без ошибок).

Если увидишь что-то вроде «Added MCP server» или просто возврат к приглашению терминала — всё готово.

---

5. Запусти Claude Code и

проверь

В терминале введи:

claude

Нажми Enter и дождись запуска Claude Code.
Спроси, например:

Найди в интернете последние фичи Next.js 16

или:

Скрапни страницу firecrawl.dev и кратко расскажи, что это за сервис

Если Claude выполняет поиск или скрапинг — Firecrawl подключён и работает.

---

Windows

1.

Зарегистрируйся на Firecrawl и получи API-ключ

Открой в браузере: https://firecrawl.dev/app
Нажми Sign up (или Log in, если

уже есть аккаунт) и войди через Google или email.

После входа открой раздел с API-ключом (обычно **API

Keys или Settings → API**).

Нажми Create API Key (или **Copy API

Key**, если ключ уже есть).

Скопируй ключ и сохрани его. Он понадобится в следующем шаге.

Важно: Ключ показывают один раз. Если потеряешь —
создай новый в кабинете Firecrawl.

---

2. Открой

Терминал (PowerShell или Command Prompt)

Способ 1 — через поиск:

Нажми Win + S (или кликни по иконке лупы рядом с

Пуск)

Напиши PowerShell или cmd
Нажми Enter

Способ 2 — через меню Пуск:

Открой Пуск
Найди Windows PowerShell или **Командная

строка**

Запусти приложение

---

3. Добавь Firecrawl MCP в

Claude Code

В терминале выполни команду, подставив свой API-ключ вместо your-api-key:

claude mcp add firecrawl -e FIRECRAWL_API_KEY=your-api-key -- npx -y firecrawl-mcp

Как подставить ключ:

Замени your-api-key на свой ключ (без кавычек и

пробелов), или

Скопируй команду (Ctrl + C), вставь в терминал

(Ctrl + V или правый клик → Вставить), затем замени your-api-key на свой ключ.

Пример (ключ условный):

claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-abc123xyz -- npx -y firecrawl-mcp

Нажми Enter.

---

4. Дождись окончания

установки

Появится сообщение о добавлении MCP-сервера. Дождись завершения команды без ошибок.

Если увидишь что-то вроде «Added MCP server» или возврат к приглашению терминала — всё готово.

---

5. Запусти Claude Code и

проверь

В терминале введи:

claude

Нажми Enter и дождись запуска Claude Code.
Спроси, например:

Найди в интернете последние фичи Next.js 15

или:

Скрапни страницу firecrawl.dev и кратко расскажи, что это за сервис

Если Claude выполняет поиск или скрапинг — Firecrawl подключён и работает.

---

Что можно делать с Firecrawl

После подключения в Claude Code можно просить:

Поиск в вебе:

Найди в интернете последние статьи про React Server Components за 2024 год

Скрапинг одной страницы:

Скрапни firecrawl.dev и расскажи, что это за сервис и для кого

Поиск и чтение документации:

Найди и открой документацию Stripe по payment intents и выпиши основные шаги

Claude будет использовать инструменты Firecrawl (поиск и скрапинг) автоматически, когда запрос касается веба или документации.

---

Чем

Firecrawl отличается от встроенных web_search и web_fetch

В Claude Code уже есть встроенные инструменты для веба: web_search (поиск в интернете) и web_fetch (получить содержимое страницы по URL). Зачем тогда подключать Firecrawl?

Кратко: встроенные инструменты достаточны для простых задач; Firecrawl добавляет скрапинг «как в браузере» и обход целых сайтов, когда контент подгружается через JavaScript или нужен не один URL, а карта сайта.

Поиск; *web_search / web_fetch (встроенные): Есть (web_search); Firecrawl (MCP):* Есть (поиск в вебе)
Одна страница по URL; *web_search / web_fetch (встроенные): Есть (web_fetch) — получает HTML «как есть»; Firecrawl (MCP): Есть (scrape) — выполняет JavaScript*, ждёт загрузки, возвращает уже отрендеренный текст
Сайты на React/Vue/Angular, SPA; *web_search / web_fetch (встроенные): Часто пусто или «загрузка…» — JS не выполняется; Firecrawl (MCP):* Нормально — страница рендерится в headless-браузере, контент извлекается после загрузки
Crawl (обход многих страниц, карта сайта); *web_search / web_fetch (встроенные): Нет; Firecrawl (MCP):* Есть — можно обойти разделы сайта, собрать ссылки, вытащить структуру
Настройка; *web_search / web_fetch (встроенные): Ничего не нужно; Firecrawl (MCP):* Нужен аккаунт Firecrawl, API-ключ и claude mcp add

Когда хватает встроенных web_search и web_fetch:

Нужно просто найти что-то в интернете или

прочитать одну страницу с обычным HTML (документация, статьи, простые лендинги).

Страница отдаёт контент сразу в HTML, без тяжёлого JavaScript.

Когда имеет смысл использовать Firecrawl:

Страница строится через JavaScript (SPA,

бесконечный скролл, кнопки «показать ещё») — встроенный web_fetch часто вернёт пустой или неполный контент.

Нужно обойти несколько страниц одного сайта или

получить карту/структуру сайта (crawl, map).

Нужен стабильный скрапинг сложных сайтов —

Firecrawl специально заточен под это (ожидание загрузки, выполнение JS).

Итого: для «найти в интернете» и «прочитать эту статью по ссылке» часто достаточно встроенных инструментов. Firecrawl подключают, когда важны JavaScript-рендеринг, обход многих страниц или работа с современными SPA и тяжёлыми сайтами.

---

Проверка установки

Убедиться, что MCP добавлен, можно так:

claude mcp list

В списке должен быть firecrawl (или похожее имя). Если его нет — повтори шаг 3 для своей ОС, подставив правильный API-ключ.

---

Частые проблемы

«Command not

found» или «claude is not recognized»

Claude Code не установлен или не в PATH. Сначала установи Claude Code по гайду [02-claude-code-mac](../02-claude-code-mac/guide.md) (на Mac) или аналогу для Windows, затем снова выполни команду добавления Firecrawl.

---

«npx is not

recognized» / «node is not recognized»

Node.js не установлен или не в PATH. Установи Node.js по гайду [07-nodejs](../07-nodejs/guide.md), закрой и снова открой терминал, затем повтори команду claude mcp add firecrawl ....

---