ntizar BackSearch — Búsqueda web point-in-time para Hermes Agent
Repo: https://github.com/NousResearch/hermes-plugin-backsearch (38⭐, Python, MIT, oficial de NousResearch, verificado 2026-09-07 contra README real)
Cuándo usar
Usar cuando haga falta buscar o citar información web tal como era en una fecha dada sin que se cuele evidencia posterior: backtests, research histórico con fecha de corte, reproducir una decisión pasada, o verificar "qué estaba publicado el día X". No usar para búsqueda web normal (para eso basta web_search).
Qué es
Plugin de Hermes Agent que da búsqueda y fetch web condicionados por fecha sobre un archivo de noticias congelado (BackSearch de General Reasoning). Cada petición lleva as_of: el buscador solo devuelve documentos crawlados en o antes de esa fecha, y el fetch devuelve el texto tal como se archivó entonces. Misma query + mismo as_of = mismos resultados para siempre.
Caso de uso: backtests de forecasting, investigación cuantitativa, entornos RL, benchmarks reproducibles — cualquier tarea donde la evidencia posterior a la fecha de corte NO debe filtrarse. En Mastermind: investigar "qué se sabía del mercado X en marzo" sin contaminación de noticias posteriores.
Los dos tools
| Tool | Qué hace |
|---|---|
backsearch |
Búsqueda híbrida sobre el corpus congelado: query, as_of, opcionales k, allowed_domains/blocked_domains |
backfetch |
Texto de una página desde la última captura ≤ cutoff: url, as_of, opcional prompt para resumen enfocado |
Ambos están gated en OPENREWARD_API_KEY: sin key configurada NUNCA llegan al schema del modelo → footprint cero de tools.
Instalación
# 1. Clonar al directorio de plugins de Hermes
# (~/.hermes/plugins; en esta máquina Windows: %LOCALAPPDATA%\hermes\plugins)
git clone https://github.com/NousResearch/hermes-plugin-backsearch.git ~/.hermes/plugins/backsearch
# 2. Activar
hermes plugins enable backsearch
# 3. API key — se factura contra saldo prepago OpenReward (https://openreward.ai/, formato or_...)
echo 'OPENREWARD_API_KEY=or_...' >> ~/.hermes/.env
Las sesiones nuevas recogen los tools automáticamente cuando la key existe.
Semántica clave (pitfalls)
as_ofgatea porcrawl_date, no por la fecha de publicación que declara el artículo. Una página archivada por primera vez después del cutoff jamás se devuelve, aunque afirme ser anterior — así se garantiza cero fuga post-cutoff en un backtest.- Ventana del archivo (preview): dominios de noticias, diciembre 2025 – julio 2026. Un
as_offuera de la ventana devuelve lista vacía (no error) — vacío ≠ fallo. - Facturación por request exitosa: fetch sin captura ≤ cutoff → soft 404 y NO cuesta; saldo agotado → 402 con mensaje accionable.
- Fetch capped a 15K chars — para artículos largos pasar
prompty pedir resumen enfocado en vez del texto completo. OPENREWARD_SEARCH_URLsobreescribe la URL base (https://search.openreward.ai) para testing/self-routing.- El repo vino primero como PR #71207 a hermes-agent; extrajo a plugin standalone por la política de que integraciones de servicios de terceros se distribuyen como plugins, no como core.
Tests / verificación
# Sin red ni key, desde el venv de un checkout de hermes-agent
# (HERMES_AGENT_REPO si no está en ~/.hermes/hermes-agent):
python -m pytest tests/ -q
Verificar que el plugin está vivo: hermes plugins list | grep backsearch y que la key está en el .env del home activo.
Origen
Aprendido del ciclo stars-explorer de David (Ntizar) — batch 2026-09-07. Registry: NousResearch/hermes-plugin-backsearch → category tool.