Comparador de luz y gas (CNMC) MCP server

comparador-luz-gas

<!-- mcp-name: io.github.nuncaeslupus/comparador-luz-gas -->

<!-- claude-arsenal:attribution: added by claude-arsenal's /init. Delete this block to drop it (it is not put back), or set attribution = false in the arsenal config.toml. --> <!-- /claude-arsenal:attribution -->

El comparador de ofertas de energía de la CNMC es la única comparativa oficial de tarifas de luz y gas en España, pero solo se puede usar rellenando su formulario web. Por debajo hay una API pública sin autenticación que, para una consulta doméstica normal, pide 83 parámetros.

Esto es un proxy con una API clara por delante: tres datos entran, JSON ordenado por precio sale. Pensado para que lo llame un LLM o un script, sin pasar por la web.

from comparador_luz_gas import Consulta, comparar

r = comparar(Consulta(codigo_postal="28013", consumo_anual_luz=2600, potencia=3.45))
r.ofertas[0]  # Oferta(comercializadora='CIDE HCENERGÍA S.A.U', importe_primer_anio=590.19, ...)

comparador-luz-gas --cp 28013 --consumo 2600 --texto

Además hace dos cosas que la web no: lee el QR de la factura para no tener que teclear nada, y dice en cada respuesta qué comercializadoras grandes faltan, que es la trampa principal de este comparador.

Instalación

Está en PyPI:

pip install comparador-luz-gas              # solo la consulta
pip install "comparador-luz-gas[facturas]"  # + leer el QR de un PDF o imagen
sudo apt install libzbar0 poppler-utils     # lo que necesita ese extra

Con uv, uv add comparador-luz-gas; o sin instalar nada, uvx comparador-luz-gas --cp 28013 --consumo 2600 --texto.

La API

Consulta — lo que preguntas

comparar(consulta, timeout=90) devuelve un Resultado. Es una sola petición HTTP: tarda entre 3 y 8 segundos, que es lo que tarda la CNMC.

Resultado — lo que devuelve

r.ofertas viene ordenado de más barato a más caro. r.to_dict() es lo que imprime el CLI en JSON:

Shortened. The full README is on GitHub.