Literatura Lab — Laboratorio Agéntico de Análisis Literario

Herramienta web de lectura profunda que organiza, interpreta, interroga y relaciona los componentes de una obra literaria. No resume: construye un expediente crítico con evidencia textual y trazabilidad epistemológica.

La aplicación vive en un único archivo: index.html. No requiere instalación, backend ni frameworks. Para PDF, descarga opcionalmente PDF.js desde CDN y conserva el extractor interno como respaldo sin conexión.


1. Empezar en tres minutos

  1. Descarga index.html.
  2. Ábrelo con doble clic en Chrome, Edge o Firefox (versión moderna).
  3. Carga una obra: pestaña A (pegar el texto), B (describir la obra), C (un fragmento) o D (título y autoría). También puedes cargar un archivo .txt, .pdf o .epub, o arrastrarlo sobre el cuadro de texto.
  4. Elige Pollinations u OpenRouter en la barra superior e introduce la clave correspondiente.
  5. Elige profundidad y lentes teóricos, y pulsa ▶ Ejecutar análisis.

Si abres el archivo desde el disco (file:///...) funciona igual que servido desde web: no hay llamadas a ningún servidor propio.

Al pulsar Inicio / Cargar obra, se limpia el análisis y el contenido de la obra anterior para comenzar otra; se conservan el proveedor, la clave y los ajustes de análisis.

Aviso sobre el modo D (solo título y autoría): el análisis textual detallado dependerá de la información disponible. La herramienta no inventa el contenido de la obra: marca como «Información no suficientemente sustentada» todo lo que no puede confirmarse con el material aportado.

Cargar PDF o EPUB: qué puedes esperar

Un PDF no almacena texto legible, almacena instrucciones de dibujo. Con conexión, Literatura Lab carga PDF.js desde CDN y extrae el texto dentro del navegador; el archivo nunca se sube. Si el lector avanzado no está disponible, usa el extractor interno como respaldo. Después muestra una muestra para revisar antes de analizar. En EPUB se lee el XHTML incluido en el ZIP local y se sigue el orden del spine; no se intenta convertir ilustraciones en texto.

Situación Qué ocurre
PDF con capa de texto (lo habitual en libros digitales y documentos exportados) Se extrae el texto, se unen las palabras cortadas por guion y se conservan los párrafos
PDF con varias páginas Se recorren todas las páginas respetando su orden
PDF con fuentes de codificación propia Se aplican los mapas ToUnicode cuando existen; si no, se advierte que la extracción puede ser imperfecta
PDF escaneado (páginas como imágenes) No hay texto que extraer. La herramienta lo dice claramente y sugiere aplicar OCR o exportar a texto
PDF cifrado o protegido Se avisa; si no puede leerse, se sugiere exportarlo a texto desde tu lector de PDF
EPUB estándar Se leen localmente los capítulos XHTML, en el orden de lectura del libro, junto con título y autoría si están declarados. Las imágenes se omiten
EPUB o PDF con páginas exclusivamente como imágenes No se aplica OCR: se advierte que hace falta OCR para obtener texto
Archivo .docx o .rtf No se admiten en el selector: copia y pega el texto

Limitaciones que conviene saber: la extracción de un PDF nunca es perfecta. Puede alterar la puntuación, unir los versos de un poema en un párrafo, desordenar columnas o arrastrar encabezados y números de página repetidos. Los PDF escaneados necesitan OCR externo antes de cargarlos. En EPUB se extrae el texto XHTML; las ilustraciones y páginas de imagen no se transcriben. La muestra se puede revisar antes de analizar. Los archivos muy grandes (más de 120 MB), capítulos EPUB individuales de más de 12 MB y textos de más de 60.000 caracteres se limitan o se avisan.


2. Claves: Bring Your Own Key (BYOK)

La herramienta no incluye ninguna clave. La aporta quien la usa para Pollinations u OpenRouter.

Pregunta Respuesta
¿Dónde consigo una clave? Pollinations: botón Obtener API Key → https://enter.pollinations.ai/keys. OpenRouter: https://openrouter.ai/keys
¿Dónde se guarda? Solo en tu navegador, en localStorage, separada por proveedor
¿A dónde viaja? La clave solo viaja al proveedor elegido: gen.pollinations.ai o openrouter.ai (texto, POST). Las imágenes opcionales se solicitan a image.pollinations.ai (GET) sin enviar la clave de texto
¿Aparece en el código? Nunca. Tampoco hay claves de ejemplo que parezcan reales
¿Se registra en consola o en errores? Nunca: los mensajes de error filtran la clave antes de mostrarse
¿Cómo la veo en pantalla? Solo en representación parcial: ••••••••9F2A
¿Cómo la elimino? Botón Eliminar mi API Key: borra el almacenamiento, limpia el estado y actualiza la interfaz
¿Y si Pollinations la devuelve por URL? Se detecta el parámetro, se valida el formato, se guarda y se limpia la barra de direcciones al instante

Proveedores y modelos disponibles

El selector de la barra superior permite elegir Pollinations u OpenRouter. Al cambiar de proveedor se actualiza el catálogo de modelos y se conserva la selección para la próxima vez.

Pollinations ofrece estos alias:

openai (por defecto) · openai-fast · openai-large · mistral · qwen-coder · gemini · claude · deepseek · sonar (búsqueda web)

OpenRouter requiere una clave propia y ofrece modelos como DeepSeek V4 Flash, Gemini 2.5 Flash, GPT-5 Mini y Kimi k2.6. El consumo depende del proveedor, el modelo y la profundidad elegida.


3. Las dos rutas de análisis

La herramienta separa con nitidez dos planos que después dialogan en la síntesis:

A. Análisis estructural — cómo está construida la obra y cómo sus elementos formales producen significado. Diagnóstico · Contexto · Estructura · Personajes y voz · Tiempo y espacio · Lenguaje y estilo · Temas y símbolos.

B. Análisis crítico — qué discursos, tensiones, relaciones de poder, ideologías, silencios y contradicciones moviliza, con argumentos anclados en evidencia textual. Análisis crítico · Tensiones (Grietas del texto) · Intertextualidad · Expediente crítico.

Módulos

# Módulo Agente
1 🧭 Diagnóstico Agente 1 · Recepción y diagnóstico
2 🏛 Contexto Agente 2 · Contextualizador
3 🧩 Estructura Agente 3 · Cartógrafo estructural
4 👥 Personajes y voz Agente 4 · Analista narrativo/dramático
5 ⏳ Tiempo y espacio Agente 4b
6 ✒️ Lenguaje y estilo Agente 5
7 🎭 Temas y símbolos Agente 6
8 🔍 Análisis crítico Agente 7 · Motor crítico
9 ⚡ Tensiones · Grietas Agente 8
10 🔗 Intertextualidad Agente 9
11 🗂 Expediente crítico Agente 10 · Evidencias
12 🗺 Mapa de la obra Visualización SVG
13 🧠 Mi interpretación Comparador
14 📑 Informe final Agente 11 · Síntesis
15 🎓 Modo docente Agente 12
16 🧑‍🎓 Modo estudiante Agente 13
17 🩻 Radiografía Ficha visual
18 ❓ Motor de preguntas Agente 14

Cada agente se ejecuta en cadena: recibe los resultados de los anteriores como contexto y mantiene la coherencia del expediente.


4. Tipos de obra admitidos

Novela · cuento · microrrelato · poesía · poema · epopeya · teatro · tragedia · comedia · tragicomedia · ensayo literario · crónica literaria · leyenda · mito · fábula · relato · literatura epistolar · literatura testimonial · fragmentos · textos híbridos.

Formatos de entrada: texto pegado directamente, .txt, .md, .pdf o .epub, y descripción de la obra sin texto.


5. Rigor: la regla de oro contra las alucinaciones

Los prompts internos ordenan al modelo, en cada turno:

Sistema de confianza interpretativa

🟢 Evidencia directa · 🔵 Inferencia razonable · 🟡 Interpretación · 🟠 Hipótesis · 🔴 Información no sustentada.

Son categorías epistemológicas, no porcentajes de certeza. La interfaz las muestra en cada afirmación importante y en cada fila de la matriz de evidencias.


6. Niveles de profundidad

Nivel Qué produce
Rápido Resumen estructurado + elementos esenciales
Intermedio Análisis estructural completo
Profundo (por defecto) Estructural + crítico + evidencias + tensiones
Investigación Exhaustivo + hipótesis múltiples + contraevidencias + intertextualidad + preguntas de investigación

Además, 🔬 Análisis profundo recorre seis niveles progresivos: identificación → descripción estructural → interpretación → análisis crítico → contraste de interpretaciones rivales → síntesis argumentativa. La prioridad es profundidad, no longitud.


7. Lentes teóricos

Formalismo · Estructuralismo · Narratología · Hermenéutica · Marxismo · Crítica de género · Crítica feminista · Estudios poscoloniales · Psicoanálisis · Ecocrítica · Sociocrítica · Estudios culturales · Semiótica · Estética de la recepción · Crítica histórica · Crítica intertextual · Enfoque ético · Enfoque filosófico · Lente libre.

La herramienta no impone ningún marco teórico: si no seleccionas ninguno, el análisis crítico se mantiene en el plano textual y discursivo.


8. Salidas y exportación


9. Accesibilidad y experiencia

Navegación completa por teclado, focus visible, roles y etiquetas ARIA, contraste suficiente, textos alternativos en imágenes y diseño adaptable. Nodos del mapa movibles con las flechas del teclado.

Atajos: Ctrl/⌘ + K abre el diálogo de conexión · Ctrl/⌘ + Enter ejecuta el análisis · Alt + A abre la auditoría de calidad · Esc cierra menús y paneles.

Estética de biblioteca + laboratorio + manuscrito, con tema claro y oscuro (se recuerda tu elección).


10. Arquitectura técnica


11. Estructura del repositorio

herramienta_analitica/
├── index.html                  ← LA HERRAMIENTA (archivo único)
├── h_analisis_literario.txt    ← especificación de diseño de partida
├── README.md                   ← este documento
├── _capturas/                  ← capturas de la interfaz (escritorio, móvil, oscuro, PDF)
└── _auditoria/                 ← pruebas ejecutables e informes (ver LEEME.txt)

Las carpetas _capturas y _auditoria no forman parte de la herramienta: son evidencia del proceso de verificación. Puedes borrarlas sin afectar a index.html.

Privacidad de tus archivos

El archivo que cargas (.txt o .pdf) no sale de tu navegador: se lee en memoria y se extrae su texto localmente. Al ejecutar el análisis, solo ese texto —nunca el archivo— se envía al proveedor de IA seleccionado. No hay servidor intermedio ni copia en la nube.


12. Estado de verificación

Auditorías ejecutadas durante el desarrollo (Node + Chrome, sin consumir pollen: la red se simula dentro de la página).

Prueba Resultado
Sintaxis del JavaScript correcta
Anidamiento del HTML 0 problemas
DOM renderizado por Chrome 15/15
Ejecución con DOM simulado 53/53
Ingesta de resultados de agentes 6/6
Descompresor DEFLATE propio 27/27
Extractor de PDF 15/15
Fidelidad del texto extraído del PDF 11/11
Carga de PDF en navegador real 12/12
Integración completa en Chrome real 51/51
Forma de la petición de texto POST confirmado, prompt en el cuerpo, clave en la cabecera
Sonda real sin clave HTTP 401 controlado por el servicio
Ruta GET de imágenes HTTP 200, image/jpeg
Catálogo de modelos todos los alias del selector existen
PDF con texto e imagen ilustrativa el texto se conserva y el flujo de imagen se excluye
PDF de página escaneada se marca como imagen sin capa textual y recomienda OCR
EPUB ZIP de muestra texto del capítulo, metadatos e imagen omitida verificados con DOM simulado

La batería histórica reportó 175 comprobaciones automatizadas. Se añaden las tres pruebas puntuales de PDF/EPUB indicadas arriba; la del EPUB usa un DOM simulado y no sustituye la prueba en navegador.

Para repetirlas: consulta _auditoria/LEEME.txt.

Pendiente de tu prueba: la primera ejecución con una clave real. La forma de la petición está verificada contra el servicio real, pero el análisis completo con un modelo de verdad solo puede confirmarse con tu pollen.


13. Límites conocidos y honestidad metodológica


14. Créditos y uso

Herramienta pedagógica y de investigación literaria. El análisis lo genera el modelo que elijas a través de tu propia clave de Pollinations; los prompts, la arquitectura agéntica, el sistema de evidencias y la interfaz son parte de este proyecto.

Prioridad de diseño: rigor literario + evidencia textual + arquitectura agéntica + experiencia interactiva + seguridad de la API Key.