Fuel Prices

fuel-prices

欧洲 28 个国家的汽油、柴油和 LPG 价格，每周更新，数据可追溯至 2005 年。

它是 Pipeworx 的一部分。Pipeworx 是一个 MCP 网关，可将 AI Agent 连接到 1879+ 个实时数据源。这是一个独立的非官方集成，与上游提供方无关联，未获其认可，也并非由其发布。

工具

工具	可回答的问题
fuel_price	“葡萄牙的汽油价格是多少？”——一个国家当前的每升价格。
compare_fuel_prices	“欧洲哪里柴油最便宜？”——同一周内所有国家的排名。
fuel_price_history	“今年德国的汽油涨了多少？”——每周数据序列及其变化。
fuel_price_coverage	涵盖哪些国家、周次和燃料，以及最新一周的数据有多新。

身份验证

无需身份验证。无需密钥或账户。

数据来源

欧盟委员会的 Weekly Oil Bulletin：

• 主页：https://energy.ec.europa.eu/data-and-analysis/weekly-oil-bulletin_en
• 数据序列：Weekly_Oil_Bulletin_Prices_History_maticni_4web.xlsx

欧盟成员国每周根据《理事会决定 1999/280/EC》上报零售价格，欧盟委员会发布汇总后的数据序列。数据涵盖 27 个欧盟国家和英国，以及代码为 EU 的欧盟整体汇总数据。

如何读取数据

• 源数据中的价格单位是每 1000 升。 汽油、柴油、燃料油和 LPG 均按此单位报价；原始值 2143 即每升 €2.143。每个响应都包含已换算的 price_per_litre_eur，并附上带有 unit 的原始值。
• 两种重质燃料油按吨报价，因此没有每升价格。这两种燃料的 price_per_litre_eur 为 null，不会提供虚构的换算值。
• 这是每周的全国平均价格，并非加油站的实时价格。 最新一周的数据会滞后几天，具体加油站的价格也会有所不同。每个响应都会注明 week_ending，以免误将数据称为“今天”的价格。
• EU 是汇总数据，不是国家。 可以直接查询，但不会纳入 compare_fuel_prices 排名。
• 比较结果固定为同一周的数据。 否则，延迟上报的国家可能会因较早且较低的价格，在“最便宜”排名中胜出。
• 不涵盖： 美国、瑞士、挪威、土耳其，以及欧盟和英国以外的所有地区。查询这些地区时，会明确拒绝并返回 country_not_covered，说明原因，而不是返回空结果。

刷新数据

欧盟委员会重新发布公告后，每周刷新一次：

node scripts/ingest-eu-oil-bulletin.mjs              # full history
node scripts/ingest-eu-oil-bulletin.mjs --weeks 8    # just the recent tail

脚本无需依赖项即可解析工作簿——xlsx 文件是一个 XML 压缩包，而 node 自带 zlib。脚本会按 (country_code, week_ending, fuel) 更新或插入数据，因此某一周停止发布后，仍会保留该周最后已知的数值。

在以下两种情况下，脚本会拒绝加载，而不是发出警告，因为这两种情况都会生成看似合理、实则错误的数据序列：

• 解析到的最新一周早于当前日期超过 45 天（源数据按时间倒序排列，因此布局变化可能会导致脚本静默地只解析到 2005 年 1 月）；
• 任意记录缺少单位。

快速开始

将其添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "fuel-prices": {
      "url": "https://gateway.pipeworx.io/fuel-prices/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/fuel-prices/mcp 返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall，还有网关级工具集中的其他工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点除了列出该工具包自己的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天适用范围的权威说明。

这是有意设计的，并非意外多路复用。元工具让限定范围的连接也能回答本工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中路由——无需再添加第二个 MCP 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的架构信息耗费的上下文比路由带来的收益还多，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具包的工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/fuel_price \
  -H 'Content-Type: application/json' \
  -d '{"country":"Portugal"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/fuel_price。查找工具包：POST https://gateway.pipeworx.io/v1/tools/search_packs，请求体为 {"query":"..."}。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关往返：

{
  "mcpServers": {
    "fuel-prices": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-fuel-prices"]
    }
  }
}

或者直接运行，确认它能够启动：

npx -y @pipeworx/mcp-fuel-prices

它通过 stdin/stdout 使用 MCP 通信，并对 initialize/tools/list/tools/call 作出响应，仅提供此工具包的工具——不包含上述网关连接添加的任何共享元工具。使用相同的源代码和工具，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以用日常语言提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Fuel Prices data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT