The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Factura Luz listing page.
Aplicación 100% cliente (sin backend) que explica tu factura de la luz. Sube tu factura (PDF o imagen), el navegador lee el código QR de la CNMC y te muestra un desglose claro de lo que estás pagando: potencia, energía, impuestos y contrato.
👉 Pruébala en vivo: entiende-tu-factura
Privacidad: todo el procesamiento ocurre en tu navegador. Tu factura nunca se envía a ningún servidor.
jsqr + pdfjs-distSi prefieres que sea tu agente quien lea la factura, hay un servidor MCP que expone la
misma lógica: factura-luz-mcp. Se ejecuta en local, así que la factura
tampoco sale de tu ordenador.
O, si prefieres solo el servidor MCP sin el comando /entender:
Si quieres comparar ofertas y ahorrar en tu factura, visita InvoiceDown.
.nvmrc → 22.20.0)| Script | Descripción |
|---|---|
npm run dev | Servidor de desarrollo (Vite) |
npm run build | Typecheck + build de producción a dist/ |
npm run preview | Sirve el build de producción |
npm test | Tests (Vitest) |
npm run typecheck | Comprobación de tipos sin emitir |
npm run format | Formatea con Prettier |
npm run validate | format:check + typecheck + test + MCP |
npm run build:mcp | Compila el servidor MCP a mcp/dist |
npm run test:mcp | Typecheck + tests del servidor MCP |
src/lib/cnmc/ es compartido: la web y el servidor MCP calculan con el mismo código.
Solo extraction/extractor.ts depende del navegador; extraction/scan.ts y
extraction/pdf.ts no tocan el DOM y se reutilizan en Node.
Push a main despliega automáticamente a GitHub Pages
(.github/workflows/deploy.yml), disponible en
https://ilopezluna.github.io/entiende-tu-factura/. El base de Vite es
relativo (./), por lo que funciona tanto en usuario.github.io/<repo>/ como en un
dominio propio.