PVPC España

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.

Security Scan

The skill's code, instructions, and requirements are coherent with its stated purpose (querying PVPC prices from the public ESIOS endpoint and suggesting cheap hours); no unrelated credentials or installers are requested.

Purpose & Capability

Name/description match the actual behavior: the scripts fetch PVPC prices from a public ESIOS endpoint, compute stats, classify prices, find cheap ranges and optimal windows for appliances. There are no required env vars, no unrelated binaries, and no requests for cloud credentials—everything requested is proportional to the stated purpose.

Instruction Scope

SKILL.md instructs the agent to run the included scripts which only query the public ESIOS API and perform local calculations. The instructions do not ask to read unrelated files or transmit data to unknown endpoints. Minor inconsistencies: SKILL.md examples show a 1.5-hour duration for 'secadora' but optimize_appliance.py requires an integer --duration (the script will treat duration as int and reject non-integers). Also the skill states it doesn't detect holidays (documented), and tarifa_periodos.py uses a simplified summer-time check and comments that may be slightly inconsistent with real DST rules (functional bug, not exfiltration).

Install Mechanism

There is no install spec (instruction-only), which reduces installer risk. However, the skill includes executable Python scripts bundled in the skill. Running those scripts will execute code from an unknown source on the host — this is expected for code-providing skills but means users should inspect or sandbox before running if the source is untrusted.

Credentials

No environment variables, tokens, or credentials are requested. The only external interaction is HTTPS GET requests to a documented ESIOS public endpoint (no authentication headers required). This level of access is proportional to the task.

Persistence & Privilege

The skill does not request persistent presence (always:false). It does not modify other skills or system-wide configuration according to the package contents. The default model invocation is allowed (normal for skills) but there is no additional privileged behavior.

Assessment

This skill appears to do what it claims: it queries the public ESIOS PVPC endpoint and computes cheap-hour recommendations. Before installing/running: (1) review the bundled Python scripts locally or run them in a sandbox — there is no install step, but executing the scripts runs code from an unknown source; (2) note the tool requires internet access to https://api.esios.ree.es and does not use or request any tokens; (3) be aware of minor functional inconsistencies (example: SKILL.md shows a 1.5h duration for 'secadora' while the script requires integer hours — pass an integer or adjust the script) and that holidays/timezone/DST handling is simplistic; (4) if you plan automated use, run with --json and validate outputs against a trusted source for a few runs. If you don't trust the unknown publisher, consider copying only the specific logic you need or reviewing the code line-by-line before execution.

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.

# Precio actual completo
python scripts/get_pvpc.py --now

# Clasificación detallada
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.

# Periodo actual
python scripts/tarifa_periodos.py --now

# Ver todos los periodos
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.

# Rangos baratos (por defecto percentil 30)
python scripts/find_cheap_ranges.py

# Ajustar percentil
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.

# Lavadora (2 horas por defecto)
python scripts/optimize_appliance.py --duration 2 --name lavadora

# Lavavajillas (3 horas)
python scripts/optimize_appliance.py --duration 3 --name lavavajillas

# Secadora (1.5 horas)
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