Brave 検索

​

API キーを取得する

1. https://brave.com/search/api/ で Brave Search API アカウントを作成します。
2. ダッシュボードで Search プランを選択し、API キーを生成します。
3. キーを設定に保存するか、Gateway 環境で BRAVE_API_KEY を設定します。

​

設定例

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

• web (デフォルト): タイトル、URL、スニペットを含む通常の Brave ウェブ検索
• llm-context: グラウンディング用に事前抽出されたテキストチャンクとソースを含む Brave LLM Context API

​

ツールパラメーター

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​

注記

• OpenClaw は Brave Search プランを使用します。従来のサブスクリプション (例: 月2,000クエリの元の Free プラン) を持っている場合、それは引き続き有効ですが、LLM Context やより高いレート制限などの新しい機能は含まれません。
• 各 Brave プランには、月額 $5 の無料クレジット (更新あり) が含まれます。Search プランは1,000リクエストあたり $5 のため、このクレジットで月1,000クエリをカバーできます。予期しない請求を避けるため、Brave ダッシュボードで使用量上限を設定してください。現在のプランについては Brave API ポータル を参照してください。
• Search プランには LLM Context エンドポイントと AI 推論権限が含まれます。モデルのトレーニングまたはチューニングのために結果を保存するには、明示的な保存権限を含むプランが必要です。Brave の 利用規約 を参照してください。
• llm-context モードは、通常のウェブ検索スニペット形式の代わりに、グラウンディングされたソースエントリを返します。
• llm-context モードは freshness と、範囲指定された date_after + date_before をサポートします。ui_lang はサポートしません。date_after なしの date_before は拒否されます。Brave ではカスタムの freshness 範囲に開始日と終了日の両方が必要なためです。
• ui_lang には en-US のような地域サブタグを含める必要があります。
• 結果はデフォルトで15分間キャッシュされます (cacheTtlMinutes で設定可能)。
• カスタム webSearch.baseUrl 値は Brave キャッシュ ID に含まれるため、 プロキシ固有のレスポンスが衝突しません。
• トラブルシューティング中に Brave リクエスト URL/クエリパラメーター、レスポンスのステータス/タイミング、検索キャッシュのヒット/ミス/書き込みイベントをログに記録するには、brave.http 診断フラグを有効にします。このフラグは API キーやレスポンス本文をログに記録することはありませんが、検索クエリには機微な情報が含まれる場合があります。

​

関連

• Web Search 概要 — すべてのプロバイダーと自動検出
• Perplexity Search — ドメインフィルタリング付きの構造化結果
• Exa Search — コンテンツ抽出付きのニューラル検索