Пошук 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: "renewable energy",
  country: "DE",
  language: "de",
});

// Нещодавні результати (за останній тиждень)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Пошук за діапазоном дат
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​

Примітки

• OpenClaw використовує план Brave Search. Якщо у вас є застаріла підписка (наприклад, початковий план Free із 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 — нейронний пошук із вилученням вмісту