forage
Forage es un servicio autoalojado ligero para búsqueda web y extracción de contenido, diseñado como alternativa a Firecrawl. Funciona como backend para Hermes Agent o standalone vía REST API. Usa un único contenedor Docker con FastAPI, Chromium y múltiples motores de renderizado.
Ficha actualizada 24 sept 2026, 12:39 · upstream 24 sept 2026, 12:31 · release v1.0.0
Qué es forage
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Forage es un servicio autoalojado de búsqueda web y extracción de contenido diseñado específicamente para Hermes Agent pero totalmente usable de forma independiente a través de su REST API. Funciona como alternativa ligera a Firecrawl, reduciendo la infraestructura necesaria de seis contenedores a uno único que realiza ambas funciones: búsqueda web y extracción de páginas.
El servicio utiliza FastAPI como framework principal con Chromium (vía Playwright, Patchright o Scrapling) para renderizado en el navegador. Soporta múltiples motores de extracción híbrida: primero intenta HTTP estático para velocidad, con fallback automático a navegador cuando se requiere JavaScript o protección anti-bot. Incluye cuatro motores de navegador configurables y dos extractores principales (readability y trafilatura).
La arquitectura incluye PostgreSQL y Redis como bases de datos, RabbitMQ para colas, y soporte nativo para Firecrawl-compatible API en el mismo puerto (:3672). Ofrece integración con Hermes Agent mediante plugin incluido, autenticación opcional por Bearer API-key, caché en memoria con TTL configurable y configuración gestionada vía config.yaml.
- Backend de búsqueda web para Hermes Agent sin depender de Firecrawl
- Extracción de contenido web con soporte anti-bot y múltiples motores de navegador
- Reemplazo drop-in de Firecrawl para clientes existentes cambiando solo la URL base
- Búsqueda SERP propia con renderizado en contenedor (Google, Bing, Yahoo, DuckDuckGo)
- Extracción de PDF y documentos ofimáticos detectados por extensión o Content-Type
- Un único contenedor Docker que reemplaza la pila de seis contenedores de Firecrawl
- API compatible con Firecrawl en /v1/scrape para migración transparente
- Cuatro motores de navegador configurables: scrapling, playwright, patchright y chrome-local
- Extracción híbrida estático + navegador con fallback automático anti-bot
- Soporte nativo para Hermes Agent con plugin WebSearchProvider incluido
- Licencia GPL v3 con código abierto verificable en repositorio
- Requiere Docker Engine 24+ con Docker Compose v2 instalado previamente
- Necesita ~3 GB de disco libre para la imagen incluyendo Chromium
- La caché de búsqueda está desactivada por defecto en extracciones
- Algunas opciones avanzadas de Firecrawl se ignoran y reportan en warning
- El modo chrome-local requiere configuración manual de endpoint CDP
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar con docker compose up -d. Configurar config.yaml (bind-mounted read-only) y .env para secretos como FORAGE_API_KEYS. Puerto 3672 por defecto. Verificar salud con curl localhost:3672/health. Para Hermes Agent, configurar web.search_backend y web.extract_backend en plugin. Opcional: añadir SearXNG vía docker-compose.override.yml si se delega búsqueda externa.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.