Lee y explica facturas de la luz españolas (QR de la CNMC). Todo en local.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for factura-luz, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
Entiende tu factura
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.
Stack
- React 19 + Vite + TypeScript
- Tailwind CSS v4
- Extracción de QR/PDF con
jsqr+pdfjs-dist - Tests con Vitest
Para agentes
Si 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:
Más servicios
Si quieres comparar ofertas y ahorrar en tu factura, visita InvoiceDown.
Requisitos
- Node.js (ver
.nvmrc→ 22.20.0)
Desarrollo
Scripts
| 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 |
Estructura
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.
Despliegue
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.
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Factura Luz
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/factura-luz)HTML Embed
<a href="https://allmcps.com/mcp/factura-luz"><img src="https://allmcps.com/api/badge/factura-luz?style=directory" alt="Factura Luz on AllMCPs" /></a>