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

Параметры

Советы

• --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 &