Engawa

El kit de herramientas abierto para sitios web nativos de agentes.

Trae tu agente.

Engawa ayuda a los sitios web a exponer una interfaz de primera clase para agentes de IA junto al sitio orientado a humanos. Los visitantes pueden traer el agente en el que ya confían en lugar de usar otro chatbot integrado.

Por qué Engawa

Los sitios web tradicionales se optimizan para humanos que navegan por HTML. Los agentes que extraen ese HTML obtienen un contexto ruidoso e incompleto. Engawa se sitúa entre tu sitio y el ecosistema de agentes, como un engawa, el espacio de transición entre el interior y el exterior en la arquitectura japonesa.

                    WEBSITE
                       │
          ┌────────────┴────────────┐
          │                         │
     Human interface          Agent interface
          │                         │
       HTML/UI                  Engawa
                                    │
                           ┌────────┼────────┐
                           │        │        │
                       llms.txt    MCP    content

Related MCP server: minimal-mcp-web-search

Qué hace

• Valida la configuración genérica del sitio (EngawaConfig)

• Normaliza el contenido mediante adaptadores conectables

• Genera archivos de descubrimiento llms.txt v2

• Expone recursos MCP y herramientas seguras de solo lectura (p. ej. search_site)

• Documenta un perfil de implementación para sitios web nativos de agentes

Estado actual

Base temprana v0.1. No endurecida para producción. La API puede cambiar antes de 1.0.

Ejemplo rápido

Consulta examples/minimal-site para ver Example Studio, un sitio ficticio con llms.txt, páginas markdown y un endpoint MCP.

pnpm install
pnpm build
pnpm --filter minimal-site start

Requiere Node.js 24 LTS (consulta CONTRIBUTING.md).

Paquetes

Planificado (no en v0.1): interfaz React, adaptadores Next.js, CLI, analíticas.

Valores de seguridad predeterminados

Los endpoints públicos de Engawa son de solo lectura por defecto en v0.1. Sin mutación no autenticada, sin acceso a secretos, entrada y resultados de búsqueda limitados. Consulta docs/security-model.md.

Licencias

• Código fuente: MIT

• Documentación y perfiles: CC BY 4.0

Hoja de ruta

Consulta docs/roadmap.md.

Contribuciones

Consulta CONTRIBUTING.md.

Licencia

MIT para el software. CC BY 4.0 para la documentación. Copyright Thierry Gilgen ICT, 2026.