POST https://api.firecrawl.ru/api/v1/search

# Вариант 1: X-API-Key заголовок (рекомендуемый)
X-API-Key: YOUR_API_KEY

# Вариант 2: Bearer токен
Authorization: Bearer YOUR_API_KEY

# Вариант 3: Query параметр
?api_key=YOUR_API_KEY

{
  "success": true,
  "url": "",
  "data": {
    "pages": [
      {
        "url": "https://example-news.ru/ai-breakthrough",
        "title": "Прорыв в области искусственного интеллекта",
        "description": "Новые достижения в области ИИ революционизируют индустрию...",
        "score": 9
      }
    ],
    "total": 1284,
    "completed": 10,
    "status": "completed",
    "metadata": {
      "title": "Результаты поиска",
      "description": "Поиск по запросу: искусственный интеллект новости"
    },
    "processingInfo": {
      "method": "searxng_search",
      "duration": 2214,
      "parser": "local"
    }
  },
  "source": "local",
  "processingTime": 2214
}

{
  "success": true,
  "url": "",
  "data": {
    "markdown": "# Анализ поиска по JavaScript фреймворкам\n\n## Найденные материалы\n\n### React - https://react.dev/learn\nОфициальная документация React предлагает комплексное руководство по изучению современной веб-разработки с использованием компонентного подхода.\n\n**Ключевые особенности:**\n- Компонентная архитектура для создания пользовательских интерфейсов\n- Хуки для использования состояния в функциональных компонентах\n- JSX синтаксис для создания элементов интерфейса\n- Виртуальный DOM для высокой производительности\n\n### Vue.js - https://vuejs.org/guide/\nПрогрессивный JavaScript фреймворк для создания пользовательских интерфейсов.\n\n## Сравнение фреймворков\n\n| Фреймворк | Сложность изучения | Производительность | Экосистема |\n|-----------|-------------------|-------------------|------------|\n| React | Средняя | Высокая | Очень богатая |\n| Vue.js | Низкая | Высокая | Богатая |\n| Angular | Высокая | Высокая | Богатая |",
    "pages": [
      {
        "url": "https://react.dev/learn",
        "title": "React Documentation - Learn React",
        "description": "Официальная документация React для изучения современной разработки"
      }
    ],
    "total": 3,
    "completed": 3,
    "status": "completed",
    "metadata": {
      "title": "AI анализ JavaScript фреймворков",
      "description": "Сравнительный анализ популярных JavaScript фреймворков и их преимуществ"
    },
    "processingInfo": {
      "method": "ai_search_analysis", 
      "duration": 15613,
      "parser": "local"
    }
  },
  "source": "local",
  "processingTime": 15613
}

{
  "query": "технологии",
  "sources": ["news"],  // Только новости
  "limit": 10
}

{
  "query": "стартапы",
  "categories": ["бизнес", "технологии"],
  "limit": 5
}

{
  "success": false,
  "url": "",
  "data": {
    "results": [],
    "totalResults": 0,
    "searchQuery": ""
  },
  "error": "Поисковый сервис временно недоступен",
  "source": "cloud",
  "processingTime": 1000
}

// ❌ Неэффективно - анализ всех результатов
{
  "query": "новости технологий",
  "limit": 10,
  "parseResults": true,
  "aiParseLimit": 10  // Максимальный расход
}

// ✅ Эффективно - фокус на лучших результатах  
{
  "query": "новости технологий", 
  "limit": 10,
  "parseResults": true,
  "aiParseLimit": 3   // Оптимальный баланс
}

// ✅ Конкретный промпт
{
  "aiPrompt": "Выдели ТОП-3 технологических тренда и их влияние на рынок"
}

// ✅ Структурированный запрос
{
  "aiPrompt": "Создай сравнительную таблицу преимуществ и недостатков упомянутых технологий"
}

// ❌ Слишком общий
{
  "aiPrompt": "Расскажи про технологии"
}