Firecrawl Build Search

Интеграция Firecrawl /search в код продукта и агентские воркфлоу. Используйте когда приложению нужна обнаружение перед извлечением — когда функция начинается с запроса, а не с URL.

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

• Пользователь задаёт вопрос, и продукт должен сначала найти источники
• Функция требует актуальных веб-результатов
• Нужно превратить поисковый запрос в короткий список страниц для последующего скрапинга

Рекомендации по умолчанию

• Используйте /search первым, когда обнаружение URL является частью поведения продукта
• Держите поиск и извлечение концептуально раздельными, если только скрапинг результатов поиска явно не требуется
• Предпочитайте выборочное последующее извлечение широкой гидратации, когда важны стоимость или задержка

Типичные паттерны продукта

• Генерация ответов с цитируемыми источниками
• Обнаружение компаний, конкурентов или тем
• Исследовательские воркфлоу, формирующие короткий список перед глубоким извлечением
• Конвейеры query→URL для последующего /scrape или /interact

Правила эскалации

• Если URL уже известен — используйте firecrawl-build-scrape
• Если страница результатов требует кликов или взаимодействия с формой — эскалируйте до firecrawl-build-interact

Заметки по реализации

• Рассматривайте /search как обнаружение, ранжирование и выбор источников
• Явно указывайте, что нужно продукту: фрагменты, URL или полный контент результатов
• Сохраняйте стабильный контракт запроса, чтобы логика последующего скрапинга оставалась предсказуемой

Документация (источник истины)

Прочитайте страницу источника истины для языка вашего проекта перед написанием кода интеграции:

• Node / TypeScript: docs.firecrawl.dev/agent-source-of-truth/node
• Python: docs.firecrawl.dev/agent-source-of-truth/python
• Rust: docs.firecrawl.dev/agent-source-of-truth/rust
• Java: docs.firecrawl.dev/agent-source-of-truth/java
• Elixir: docs.firecrawl.dev/agent-source-of-truth/elixir
• cURL / REST: docs.firecrawl.dev/agent-source-of-truth/curl