Pesquisa do Brave

​

Obter uma chave de API

1. Crie uma conta da API Brave Search em https://brave.com/search/api/
2. No painel, escolha o plano Search e gere uma chave de API.
3. Armazene a chave na configuração ou defina BRAVE_API_KEY no ambiente do Gateway.

​

Exemplo de configuração

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // ou "llm-context"
            baseUrl: "https://api.search.brave.com", // substituição opcional da URL base/do proxy
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

• web (padrão): pesquisa normal na web do Brave, com títulos, URLs e trechos
• llm-context: API Brave LLM Context, com blocos de texto pré-extraídos e fontes para fundamentação

​

Parâmetros da ferramenta

// Pesquisa específica por país e idioma
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Resultados recentes (última semana)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Pesquisa por intervalo de datas
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​

Observações

• O OpenClaw usa o plano Search do Brave. Se você tiver uma assinatura legada (por exemplo, o plano Free original com 2.000 consultas/mês), ela continuará válida, mas não incluirá recursos mais recentes, como LLM Context ou limites de taxa mais altos.
• Cada plano do Brave inclui $5/mês em créditos gratuitos (renovados mensalmente). O plano Search custa $5 por 1.000 solicitações, portanto o crédito cobre 1.000 consultas/mês. Defina seu limite de uso no painel do Brave para evitar cobranças inesperadas. Consulte o portal da API do Brave para ver os planos atuais.
• O plano Search inclui o endpoint LLM Context e direitos de inferência de IA. O armazenamento de resultados para treinar ou ajustar modelos requer um plano com direitos explícitos de armazenamento. Consulte os Termos de Serviço do Brave.
• O modo llm-context retorna entradas de fontes fundamentadas em vez do formato normal de trechos da pesquisa na web.
• O modo llm-context aceita freshness e intervalos limitados de date_after + date_before. Ele não aceita ui_lang; date_before sem date_after é rejeitado porque o Brave exige que intervalos de atualidade personalizados incluam as datas inicial e final.
• ui_lang deve incluir uma subtag de região, como en-US.
• Por padrão, os resultados permanecem em cache por 15 minutos (configurável por meio de cacheTtlMinutes).
• Valores personalizados de webSearch.baseUrl são incluídos na identidade do cache do Brave, para que respostas específicas do proxy não entrem em conflito.
• Ative a opção de diagnóstico brave.http para registrar URLs/parâmetros de consulta das solicitações do Brave, status/tempo das respostas e eventos de acerto/erro/gravação do cache de pesquisa durante a solução de problemas. A opção nunca registra a chave de API nem os corpos das respostas, mas as consultas de pesquisa podem conter dados sensíveis.

​

Conteúdo relacionado

• Visão geral da pesquisa na web — todos os provedores e detecção automática
• Pesquisa do Perplexity — resultados estruturados com filtragem por domínio
• Pesquisa do Exa — pesquisa neural com extração de conteúdo