Imagine a cena: você entrega a um LLM um desafio de previsão — “esta empresa vai lançar o novo produto no mês que vem?” — e ele responde com uma confiança suspeita. O problema? Ele pesquisou na web ao vivo, que já conhece a resposta. Cada “previsão” que ele faz fica silenciosamente contaminada pelo retrovisor. Pesquisadores quantitativos batem na mesma parede: ao fazer backtest de um agente de trading, os resultados de busca que você alimenta vêm de hoje, então sua simulação supostamente histórica está espiando o futuro sem você perceber.

Esse é o problema de vazamento de informação (leakage), e é exatamente o que o BackSearch foi feito para resolver. É um arquivo de notícias congelado: cada requisição carrega uma data as_of, a busca só retorna documentos rastreados até essa data, e o fetch retorna o texto do artigo como foi arquivado naquele momento. Mesma consulta + mesmo as_of = mesmos resultados, para sempre. Em 29 de agosto, Teknium, da Nous Research, anunciou o plugin oficial autônomo para Hermes — hermes-plugin-backsearch — dando ao Hermes uma verdadeira máquina do tempo para pesquisa na web.

Por que um filtro de data não basta

Você pode pensar que uma API de busca ao vivo com um parâmetro date: já resolve. Não resolve. APIs ao vivo classificam o índice de hoje com retrospectiva — elas sabem quais artigos importaram e entregam bytes de uma página que talvez tenha sido reescrita desde que o evento se resolveu. O corpus do BackSearch, por outro lado, nunca se move: a filtragem usa crawl_date (quando o arquivo realmente capturou a página), não a data de publicação que o artigo afirma ter. Uma página arquivada pela primeira vez depois do seu corte nunca é retornada, mesmo que alegue uma data de publicação anterior. É essa garantia que torna um backtest honesto.

O plugin oficial do Hermes

O hermes-plugin-backsearch é um plugin oficial publicado sob a organização NousResearch (v1.0.0, MIT). Ele é autônomo, não embutido — nasceu como PR #71207 no repositório principal e foi extraído para um repositório próprio, seguindo a política do projeto de que integrações com serviços de terceiros são publicadas como plugins, não como código do núcleo.

O plugin registra duas ferramentas de modelo, ambas controladas por OPENREWARD_API_KEY. Sem a chave configurada, elas nunca chegam ao schema de ferramentas do modelo — a pegada é literalmente zero. Você pode instalar agora e não custa nada até adicionar uma chave:

Ferramenta	O que faz
backsearch	Busca híbrida no corpus congelado em uma data (query, as_of, k opcional, allowed_domains/blocked_domains)
backfetch	Busca o texto extraído de uma página do último capture em ou antes da data de corte (url, as_of, prompt opcional para um resumo focado)

Instalação

Três passos, direto do README oficial:

# 1. Clone no diretório de plugins do Hermes
git clone https://github.com/NousResearch/hermes-plugin-backsearch.git ~/.hermes/plugins/backsearch

# 2. Ative o plugin
hermes plugins enable backsearch

# 3. Adicione a chave de API (obtenha em https://openreward.ai — começa com or_)
echo 'OPENREWARD_API_KEY=or_...' >> ~/.hermes/.env

Você também pode instalar direto do GitHub via CLI: hermes plugins install NousResearch/hermes-plugin-backsearch. Novas sessões carregam as ferramentas automaticamente assim que a chave estiver presente. Uma nota honesta: este artigo se baseia na documentação oficial do repositório (v1.0.0); ao escrever, ainda não tínhamos configurado uma chave OpenReward em uma máquina de teste, então as descrições de comportamento refletem a semântica documentada, não uma sessão real.

Para entender como o Hermes descobre e gerencia plugins — incluindo os comandos hermes plugins usados acima — veja a referência do comando hermes plugins. Se você é novo no Hermes, comece pelo guia de instalação.

Referência das ferramentas

backsearch

Parâmetro	Significado
query	A consulta (híbrida: palavras-chave + semântica)
as_of	Data no formato YYYY-MM-DD; só retorna documentos rastreados até ela
k	Opcional, número de resultados
allowed_domains	Opcional lista de permissões — mutuamente exclusivo com blocked_domains
blocked_domains	Opcional lista de bloqueios — mutuamente exclusivo com allowed_domains

backfetch

Parâmetro	Significado
url	A página a buscar
as_of	Data de corte; retorna o último capture em ou antes dela
prompt	Opcional — peça um resumo focado de um artigo longo em vez do texto bruto

Algumas semânticas que valem conhecer:

• Limite de 15K caracteres no texto buscado — passe um prompt para obter um resumo focado de um artigo longo.
• 404 suave: um fetch sem capture em ou antes da data de corte retorna um resultado recuperável de “sem capture” e não custa nada.
• 402: saldo OpenReward esgotado retorna um erro acionável.
• Janela do arquivo: a prévia atual cobre domínios de notícias, dezembro de 2025 – julho de 2026. Um as_of fora da janela retorna lista vazia — não um erro.
• Cobrança: por requisição bem-sucedida contra saldo pré-pago do OpenReward.
• OPENREWARD_SEARCH_URL substitui a URL base (https://search.openreward.ai) para testes e roteamento próprio.

O que você pode fazer com isso

• Backtests de previsão — reexecute o mesmo agente em diferentes datas as_of e meça exatamente quando a previsão dele muda. É a demo que Teknium esboçou no dia do lançamento: congele a web, reexecute o agente e observe o momento em que ele para de adivinhar e começa a saber.
• Loops de pesquisa quantitativa — teste ideias de estratégia contra um corpus que não se move sob seus pés.
• Ambientes RL — avalie agentes em instantâneos históricos sem vazamento pós-corte no sinal de recompensa.
• Benchmarks reproduzíveis — mesma consulta, mesma data, mesmos resultados para sempre: um benchmark que pode ser reexecutado anos depois e continuar significando o mesmo.
• Verificação “na data de” — confirme o que era realmente conhecido (ou não) em uma data específica.

Pesquisar na web já é um dos superpoderes padrão do Hermes — nosso guia dos cinco canais de busca gratuitos cobre as opções do dia a dia. O BackSearch é outro bicho: troca a frescura do tempo real pelo determinismo histórico, que é exatamente o que fluxos de avaliação e previsão precisam.

Limites que você precisa conhecer

O arquivo de prévia é deliberadamente estreito: domínios de notícias, dezembro de 2025 – julho de 2026. Se o seu as_of cair fora dessa janela, você recebe um conjunto de resultados vazio em vez de erro — então planeje em função da janela. O serviço cobra por requisição bem-sucedida contra saldo pré-pago do OpenReward (404s suaves são gratuitos), e o plugin não faz nada até você configurar a chave. É uma ferramenta jovem, feita sob medida para um nicho jovem e específico — e a licença MIT facilita inspecionar exatamente o que ela faz antes de instalar.

O ecossistema de plugins do Hermes cresce rápido — explore o hub do ecossistema para ver o que mais existe por aí.