​

Brave Search API

​

Obtenha uma chave de API

1. Crie uma conta da Brave Search API em https://brave.com/search/api/
2. No dashboard, 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"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

• web (padrão): busca web normal da Brave com títulos, URLs e snippets
• llm-context: API LLM Context da Brave com blocos de texto previamente extraídos e fontes para grounding

​

Parâmetros da ferramenta

// Busca 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",
});

// Busca 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 da Brave. Se você tiver uma assinatura legada (por exemplo, o plano Free original com 2.000 consultas/mês), ela continua válida, mas não inclui recursos mais novos, como LLM Context ou limites de taxa mais altos.
• Cada plano Brave inclui **US$5/mês em crédito gratuito** (renovável). O plano Search custa US$5 por 1.000 solicitações, então o crédito cobre 1.000 consultas/mês. Defina seu limite de uso no dashboard da Brave para evitar cobranças inesperadas. Consulte o portal de API da Brave para ver os planos atuais.
• O plano Search inclui o endpoint LLM Context e direitos de inferência de IA. Armazenar resultados para treinar ou ajustar modelos exige um plano com direitos explícitos de armazenamento. Consulte os Terms of Service da Brave.
• O modo llm-context retorna entradas de fonte fundamentadas em vez do formato normal de snippet de busca web.
• O modo llm-context não oferece suporte a ui_lang, freshness, date_after ou date_before.
• ui_lang deve incluir uma subtag de região, como en-US.
• Os resultados são armazenados em cache por 15 minutos por padrão (configurável via cacheTtlMinutes).

​

Relacionado

• Visão geral de Web Search — todos os provedores e detecção automática
• Perplexity Search — resultados estruturados com filtragem por domínio
• Exa Search — busca neural com extração de conteúdo