Official Fuel Prices

官方燃油价格 API — 示例（法国、西班牙、意大利、西澳大利亚州）

文档和指南：https://fuel-prices-api.pages.dev/?utm_source=github&utm_medium=referral&utm_campaign=examples

可运行的示例，适用于 官方燃油价格， 这是一个 API，可从官方政府开放数据（法国 DGCCRF、西班牙 MITECO、意大利 MIMIT、西澳大利亚州 FuelWatch）中获取约 46,000 个加油站的站点级汽油、柴油、LPG、CNG 和氢气价格，并将数据规范化为统一的 JSON 架构，每行均包含坐标、ISO 时间戳、货币、单位、来源和许可。

示例	功能
curl/cheapest-diesel-paris.sh	一次 HTTP 调用：获取巴黎 3 km 范围内柴油价格最低的 10 个加油站
python/cheapest_nearby.py	命令行：获取任意坐标附近价格最低的加油站
python/brand_summary_pandas.py	使用 pandas 汇总马德里周边各品牌的价格中位数
javascript/cheapest-nearby.mjs	Node.js：获取某个地点附近价格最低的加油站
mcp/	Claude Desktop / Cursor 配置和 AI Agent 示例提示词

设置

1. 获取 Apify API 令牌：https://console.apify.com/settings/integrations（免费账户；按使用量付费）。
2. export APIFY_TOKEN=...
3. 运行任意示例。

MCP（AI Agent）

服务 URL：https://mcp.apify.com?tools=sste/official-fuel-prices — 可与 Claude、Cursor、VS Code 和其他 MCP 客户端配合使用（首次使用时通过 OAuth 登录）。本地运行：npx @apify/actors-mcp-server --tools sste/official-fuel-prices。

定价

每次运行 $0.005 + 每条价格记录 $0.0005（查询“价格最低的 10 个加油站”约为 $0.01）。

数据来源和许可

法国：data.economie.gouv.fr（DGCCRF），Licence Ouverte v2.0 · 西班牙：Geoportal Gasolineras（MITECO），依据 Ley 37/2007 复用 · 意大利：MIMIT Osservaprezzi，IODL 2.0 · 西澳大利亚州：FuelWatch。 本项目独立运营，与上述机构无关联。示例采用 MIT 许可证。