​

Brave Search API

​

API 키 발급 절차

1. Brave Search API 포털에 접속하여 계정을 생성함.
2. 대시보드에서 Search 요금제를 선택하고 API 키를 생성함.
3. 생성된 키를 설정 파일에 입력하거나 Gateway 환경 변수에 BRAVE_API_KEY로 등록함.

​

설정 예시

{
  tools: {
    web: {
      search: {
        provider: "brave",
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

​

도구 파라미터

// 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회 쿼리를 제공하던 기존 무료 요금제 사용자는 계속 이용 가능하나, LLM Context나 더 높은 Rate Limit와 같은 최신 기능은 포함되지 않을 수 있음.
• 각 Brave 요금제에는 매월 **$5의 무료 크레딧**이 포함되며 매월 갱신됨. Search 요금제는 1,000회 요청당$5이므로 무료 크레딧으로 약 1,000회의 쿼리를 처리할 수 있음. 예상치 못한 과금을 방지하려면 Brave 대시보드에서 사용 한도를 설정할 것을 권장함. 최신 요금 정책은 Brave API 포털에서 확인 가능함.
• Search 요금제에는 LLM Context 엔드포인트 및 AI 추론 권한이 포함됨. 검색 결과를 저장하여 모델 학습이나 튜닝에 사용하려면 명시적인 저장 권한이 포함된 요금제가 필요함. 자세한 정보는 Brave 서비스 약관을 참조함.
• 검색 결과는 기본적으로 15분간 캐싱됨 (cacheTtlMinutes로 변경 가능).