Поиск Brave

​

Получение ключа API

1. Создайте учётную запись Brave Search API на странице https://brave.com/search/api/
2. На панели управления выберите план Search и создайте ключ API.
3. Сохраните ключ в конфигурации или задайте BRAVE_API_KEY в окружении Gateway.

​

Пример конфигурации

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // или "llm-context"
            baseUrl: "https://api.search.brave.com", // необязательное переопределение прокси/базового URL
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

• web (по умолчанию): обычный веб-поиск Brave с заголовками, URL-адресами и фрагментами
• llm-context: Brave LLM Context API с предварительно извлечёнными фрагментами текста и источниками для привязки ответа к фактам

​

Параметры инструмента

// Поиск с учётом страны и языка
await web_search({
  query: "возобновляемая энергия",
  country: "DE",
  language: "de",
});

// Недавние результаты (за последнюю неделю)
await web_search({
  query: "новости ИИ",
  freshness: "week",
});

// Поиск по диапазону дат
await web_search({
  query: "развитие ИИ",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​

Примечания

• OpenClaw использует план Brave Search. Если у вас есть устаревшая подписка (например, первоначальный бесплатный план с 2 000 запросов в месяц), она остаётся действительной, но не включает новые возможности, такие как LLM Context или более высокие ограничения частоты запросов.
• Каждый план Brave включает бесплатный возобновляемый кредит в размере $5 в месяц. План Search стоит $5 за 1 000 запросов, поэтому кредит покрывает 1 000 запросов в месяц. Установите ограничение использования на панели управления Brave, чтобы избежать непредвиденных расходов. Актуальные планы см. на портале Brave API.
• План Search включает конечную точку LLM Context и права на выполнение ИИ-инференса. Для хранения результатов с целью обучения или настройки моделей требуется план, явно предоставляющий права на хранение. См. Условия предоставления услуг Brave.
• Режим llm-context возвращает записи с подтверждающими источниками вместо обычной структуры фрагментов веб-поиска.
• Режим llm-context поддерживает freshness и ограниченные диапазоны date_after + date_before. Он не поддерживает ui_lang; значение date_before без date_after отклоняется, поскольку Brave требует, чтобы пользовательские диапазоны актуальности включали начальную и конечную даты.
• ui_lang должен включать подтег региона, например en-US.
• По умолчанию результаты кэшируются на 15 минут (настраивается с помощью cacheTtlMinutes).
• Пользовательские значения webSearch.baseUrl включаются в идентификатор кэша Brave, поэтому ответы разных прокси-серверов не конфликтуют.
• Включите диагностический флаг brave.http, чтобы при устранении неполадок журналировать URL-адреса и параметры запросов Brave, состояние и длительность ответов, а также события попадания, промаха и записи кэша поиска. Флаг никогда не журналирует ключ API или тела ответов, однако поисковые запросы могут содержать конфиденциальные данные.

​

Связанные материалы

• Обзор веб-поиска — все провайдеры и автоматическое обнаружение
• Поиск Perplexity — структурированные результаты с фильтрацией по доменам
• Поиск Exa — нейронный поиск с извлечением содержимого