pvpc-spain

核心用法

PVPC España 是一款专为西班牙家庭用户设计的电价查询与用电优化工具。该技能通过调用 Red Eléctrica de España（西班牙国家电网）官方 ESIOS API，实时获取 PVPC（Precio Voluntario Pequeño Consumidor）2.0TD 分时电价数据，帮助用户在正确的时间使用电器以节省电费。

核心功能涵盖四大场景：一是实时电价查询，显示当前电价并标注为高/中/低三档；二是时段识别，自动判断当前处于峰（Punta）、平（Llano）、谷（Valle）哪个计费时段；三是低价时段推荐，找出当日价格最低的连续时间段；四是家电使用优化，针对洗衣机、洗碗机、烘干机等常用电器的运行时长，计算最优启动时间窗口。

所有脚本均支持 --json 参数输出，便于与其他自动化工具集成。数据每日约 20:00 更新次日电价，包含能源、输配电费、税费等全部成本，单位为 €/kWh。

显著优点

官方数据源保障准确性：直接对接西班牙国家电网 ESIOS 公开 API，数据权威可靠，非第三方爬取或估算。价格包含完整计费项，用户无需自行计算附加费用。

零依赖轻量设计：仅使用 Python 标准库（urllib、json、datetime 等），无第三方包依赖，部署简单，兼容性强，维护成本低。

实用场景覆盖全面：从简单的"现在电价多少"到复杂的"三小时洗碗机何时启动最省钱"，功能梯度清晰，满足不同深度需求。

透明可审计：代码完全开源，逻辑清晰，无黑箱操作，用户可自行验证算法正确性。

潜在缺点与局限性

地域限制严格：仅适用于西班牙本土的 PVPC 2.0TD 用户，其他国家和地区无法使用。非西班牙居民或采用其他电价方案（如固定价格、 indexed 价格）的用户无法获得有效建议。

无历史数据存储：每次查询均为实时 API 调用，不缓存过往价格，无法提供跨日对比、月度趋势分析等进阶功能。

节假日识别缺失：西班牙国家假日未自动识别，节假日期间实际执行全谷电价，但技能仍按普通工作日逻辑判断，可能导致时段误判。

离线不可用：完全依赖网络连接，无本地备用数据机制。

相对定价局限：高/中/低档位基于当日价格分布的百分位计算，而非历史同期对比，用户难以判断"今天是否比往常贵"。

适合的目标群体

• 西班牙境内采用 PVPC 2.0TD 电价的家庭用户（功率 <10kW）
• 希望降低电费支出、愿意调整用电时间的灵活用户
• 拥有可延时启动功能家电（如带定时器的洗衣机、洗碗机）的用户
• 对电价敏感、希望实时掌握价格波动的节能意识较强者
• 智能家居自动化爱好者，希望将电价数据接入 Home Assistant 等平台的进阶用户

使用风险

网络依赖风险：API 访问失败或延迟将导致功能完全不可用，建议避免在关键决策场景下完全依赖该工具。

数据时效性：每日 20:00 后才发布次日价格，当日 20:00 前查询次日数据将失败或返回过期信息。

节假日误判成本：国家假日若按普通工作日时段执行，可能导致用户错过全谷电价窗口，造成不必要的电费支出。建议节假日期间人工复核时段规则。

算法边界：家电优化基于价格最小化，未考虑用户作息偏好、噪音限制（如夜间洗衣）、电网负荷等实际约束，建议作为参考而非绝对指令。