| name | pvpc-spain |
| description | Consulta y optimiza precios de electricidad PVPC en España (tarifa 2.0TD para usuarios domésticos). Usa cuando necesites (1) precio actual con contexto (alto/medio/bajo vs día), (2) identificar periodos valle/llano/punta según horario, (3) encontrar las horas más baratas del día, (4) optimizar cuándo usar electrodomésticos (lavadora, lavavajillas, secadora, etc.) para minimizar coste eléctrico. |
PVPC España
Skill para consultar precios PVPC (Precio Voluntario Pequeño Consumidor) en España y optimizar el consumo eléctrico. Todos los datos se obtienen de la API pública de ESIOS (Red Eléctrica de España) para la tarifa 2.0TD.
Consultas disponibles
1. Precio actual con contexto
Muestra el precio actual clasificado como ALTO/MEDIO/BAJO según percentiles del día.
python scripts/get_pvpc.py --now
python scripts/precio_referencia.py --now
Respuesta incluye:
- Precio actual (€/kWh)
- Mínimo y máximo del día
- Clasificación: BAJO (<percentil 30), MEDIO (30-70), ALTO (>70)
- Desviación respecto a la media del día
2. Periodos tarifarios (valle/llano/punta)
Identifica el periodo actual según tarifa 2.0TD, ajustado por día de la semana.
python scripts/tarifa_periodos.py --now
python scripts/tarifa_periodos.py --all
Periodos 2.0TD:
- VALLE 🌙: 00:00-08:00 (todos los días) + sábados/domingos completos
- LLANO ⚡: 08:00-10:00, 14:00-18:00, 22:00-00:00 (lun-vie)
- PUNTA 🔴: 10:00-14:00, 18:00-22:00 (lun-vie)
Nota: Los periodos son iguales en horario de verano e invierno para 2.0TD.
3. Horas más baratas del día
Encuentra rangos de horas con precios por debajo del percentil 30 del día.
python scripts/find_cheap_ranges.py
python scripts/find_cheap_ranges.py --percentile 40
Respuesta incluye:
- Rangos de 2+ horas consecutivas con precios bajos
- Precio mínimo/máximo/medio de cada rango
- Ahorro porcentual vs media del día
- Ordenados por duración (rangos más largos primero)
4. Optimizar electrodomésticos
Encuentra la ventana de N horas consecutivas con menor coste total.
python scripts/optimize_appliance.py --duration 2 --name lavadora
python scripts/optimize_appliance.py --duration 3 --name lavavajillas
python scripts/optimize_appliance.py --duration 2 --name secadora
Respuesta incluye:
- Hora óptima de inicio y fin
- Coste total del ciclo (€)
- Desglose de precio por hora
- Ahorro vs usar en horario medio
- Hasta 2 alternativas con <10% diferencia de coste
Salida JSON
Todos los scripts soportan --json para integración programática:
python scripts/get_pvpc.py --json
python scripts/find_cheap_ranges.py --json
python scripts/optimize_appliance.py --duration 3 --json
Ejemplos de uso desde el agente
Usuario: "¿Cuánto cuesta la luz ahora?"
python scripts/get_pvpc.py --now
python scripts/precio_referencia.py --now
Usuario: "¿Cuándo es más barata la luz hoy?"
python scripts/find_cheap_ranges.py
Usuario: "¿Cuándo pongo la lavadora?"
python scripts/optimize_appliance.py --duration 2 --name lavadora
Usuario: "¿Cuándo es valle?"
python scripts/tarifa_periodos.py --now
Usuario: "¿Cuándo pongo el lavavajillas que dura 3 horas?"
python scripts/optimize_appliance.py --duration 3 --name lavavajillas
Notas técnicas
- Fuente de datos: API pública de ESIOS (Red Eléctrica de España)
- Tarifa: PVPC 2.0TD (usuarios domésticos con potencia <10 kW)
- Actualización: Los precios se publican diariamente alrededor de las 20:00 para el día siguiente
- Precios: Incluyen todos los términos (energía, peajes, cargos) en €/kWh
- Sin autenticación: Usa endpoint público, no requiere token
Limitaciones
- Los datos históricos no se almacenan localmente (cada consulta es fresh)
- La clasificación ALTO/MEDIO/BAJO es relativa al día actual, no a históricos
- Los festivos nacionales no se detectan automáticamente (se tratan como días laborables)
- Requiere conectividad a internet para consultar la API
