wattprice

Name: wattprice
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords金融数据01 周前更新

代码仓库

关于 wattprice

wattprice 通过 ESIOS API 获取西班牙受监管的 PVPC 电价。可按日期范围和地理区域查询，并设置时间及区域聚合方式。

主要功能

01以 JSON 获取 PVPC 电价
02设置日期范围和语言
03选择时间聚合与截断方式
04选择地理区域及聚合方式

适用场景

01获取当天的 PVPC 电价
02查询指定日期范围的价格
03比较西班牙不同电力区域的价格
04按小时或天请求聚合价格

MCP 相关

其 MCP 服务提供 fetch_prices 工具，可按日期范围和地理区域获取 PVPC 电价。使用时需要 ESIOS_API_KEY。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-wattprice": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/wattprice"
      ]
    }
  }
}

启动命令npx -y @reneturcios/wattprice

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/wattprice0.1.0stdio

ocighcr.io/cloudcorprecords/wattprice:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
locale	enum	否	来源文本的翻译。可接受的值：es、en。默认值为 es。es \| en
endDate	string	否	日期范围的结束时间，采用 ISO 8601 格式。默认值为今天结束时。
startDate	string	否	日期范围的开始时间，采用 ISO 8601 格式（例如 2025-06-29T00:00:00.000+02:00）。默认值为今天开始时。
timeTruncation	enum	否	如何截断数据时间序列。可接受的值：hour、day、month、year。hour \| day \| month \| year
geographicalIds	array	否	用于筛选的地理 ID。可接受的值：3 (España)、8741 (Península)、8742 (Canarias)、8743 (Baleares)、8744 (Ceuta)、8745 (Melilla)。默认值为 8741、8742、8743、8744、8745。
timeAggregation	enum	否	按时间分组时如何聚合指标值。可接受的值：sum、average。默认值为 sum。sum \| average
geographicalTruncation	enum	否	提供地理聚合时，如何按地理级别对数据分组。可接受的值：country、electric_system。country \| electric_system
geographicalAggregation	enum	否	按地理 ID 分组时如何聚合指标值。可接受的值：sum、average。默认值为 sum。sum \| average

详细介绍

wattprice

西班牙受监管的 PVPC 电价目前是多少？wattprice 会向 ESIOS API（由 Red Eléctrica de España 运营的数据服务）查询 PVPC（小型用户自愿价格）指标，并根据你选择的日期范围和地理区域，以 JSON 格式返回价格数据。

除 API 密钥外，所有参数都是可选的，默认值遵循上游文档：

locale — es（默认）或 en
startDate / endDate — ISO 8601 格式的时间范围；未指定范围时，默认为今天，从当天开始到当天结束
timeAggregation — sum（默认）或 average
timeTruncation — hour、day、month 或 year
geographicalAggregation — sum（默认）或 average
geographicalIds — 字符串 ID：3 西班牙、8741 半岛、8742 加那利群岛、8743 巴利阿里群岛、8744 休达、8745 梅利利亚；默认为五个系统 ID 8741–8745
geographicalTruncation — country 或 electric_system

配置

你需要自行提供 ESIOS API 密钥（在 esios.ree.es 免费注册）：

export ESIOS_API_KEY="your key"

如果未提供密钥，wattprice 不会猜测：调用会失败，并显示命名 ESIOS_API_KEY 的错误，且不会虚构价格。ESIOS_API_BASE 可用于覆盖 API 基础 URL（默认值为 https://api.esios.ree.es）。

CLI

ESIOS_API_KEY=... npx @reneturcios/wattprice prices
ESIOS_API_KEY=... npx @reneturcios/wattprice prices --locale en --time-truncation day --geographical-ids 8741
npx @reneturcios/wattprice --version

输出为 ESIOS 价格数据的 JSON 格式。退出代码：成功时为 0，运行时错误（包括缺少密钥或上游响应非 200）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/wattprice mcp

MCP 客户端配置：

{
  "mcpServers": {
    "wattprice": {
      "command": "npx",
      "args": ["-y", "@reneturcios/wattprice", "mcp"],
      "env": { "ESIOS_API_KEY": "your key" }
    }
  }
}

工具

fetch_prices — 获取指定日期范围和地理区域的 PVPC 电价。所有参数均为可选；请参阅上方的默认值列表。

Docker

docker run -i -e ESIOS_API_KEY="your key" ghcr.io/cloudcorprecords/wattprice
docker run --rm -e ESIOS_API_KEY="your key" ghcr.io/cloudcorprecords/wattprice prices --locale en

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, no network)
npm run dev     # run the CLI from source