Главная · Скиллы · firecrawl-search

firecrawl-searchвеб-поиск с извлечением контента

firecrawl/cli

Веб-поиск с опциональным извлечением полного содержания страниц: структурированный JSON вместо простых сниппетов.

Firecrawl поиск веб-поиск JSON результаты контент парсинг

Установка

npx -y skills add firecrawl/cli --skill firecrawl-search --agent claude-code

Firecrawl Search

Поиск в вебе с извлечением полного содержимого страниц. Используйте этот скилл, когда пользователь просит найти что-то в вебе, поискать статьи, изучить тему, найти новости, или говорит «найди», «поищи», «загугли», «что говорят о». Возвращает реальные результаты поиска с опциональным полным markdown — не только сниппеты.

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

Ещё нет конкретного URL
Нужно найти страницы, ответить на вопрос или обнаружить источники
Первый шаг в паттерне эскалации: search → scrape → map → crawl → interact

Быстрый старт

# Базовый поиск
firecrawl search "ваш запрос" -o .firecrawl/result.json --json

# Поиск + скрапинг полного содержимого результатов
firecrawl search "ваш запрос" --scrape -o .firecrawl/scraped.json --json

# Новости за последний день
firecrawl search "ваш запрос" --sources news --tbs qdr:d -o .firecrawl/news.json --json

Параметры

Параметр	Описание
`--limit <n>`	Максимальное количество результатов
`--sources <web,images,news>`	Типы источников для поиска
`--categories <github,research,pdf>`	Фильтр по категории
`--tbs <qdr:h\|d\|w\|m\|y>`	Фильтр по времени
`--location`	Локация для результатов поиска
`--country <code>`	Код страны для поиска
`--scrape`	Также скрапить полное содержимое каждого результата
`--scrape-formats`	Форматы при скрапинге (по умолчанию: markdown)
`-o, --output <path>`	Путь к файлу вывода
`--json`	Вывод в формате JSON

Советы

--scrape забирает полный контент — не нужно повторно скрапить URL из результатов поиска. Экономит кредиты.
Всегда записывайте результаты в .firecrawl/ с -o, чтобы не раздувать контекстное окно.
Используйте jq для извлечения URL или заголовков: jq -r '.data.web[].url' .firecrawl/search.json
Соглашение по именованию: .firecrawl/search-{запрос}.json

Отправка обратной связи (возврат 1 кредита)

Поиск стоит 2 кредита. После использования результатов отправьте отзыв с firecrawl search-feedback <id> — первый отзыв на поиск возвращает 1 кредит.

Правила:

Временное окно: отправить в течение ~2 минут после поиска.
--missing-content — самое важное поле: конкретные фрагменты контента, которых не оказалось. По одной теме на запись.
Для good нужен хотя бы один --valuable-sources. Для bad — --missing-content или --query-suggestions.
При dailyCapReached: true — прекратить вызовы search-feedback до следующего UTC-дня.

# Результаты были полезны
firecrawl search-feedback "$SEARCH_ID" \
  --rating good \
  --valuable-sources '[{"url":"https://react.dev/reference/react/hooks","reason":"Most authoritative"}]' \
  --missing-content '[{"topic":"useDeferredValue","description":"No example with Suspense"}]' \
  --silent &

# Частично полезны
firecrawl search-feedback "$SEARCH_ID" \
  --rating partial \
  --missing-content '[{"topic":"useTransition"},{"topic":"Server Components hooks"}]' \
  --silent &

# Не полезны
firecrawl search-feedback "$SEARCH_ID" \
  --rating bad \
  --missing-content "official api reference: missing v2 endpoints" \
  --silent &