Japan Fuel Price Mcp

io.github.atushi1841v0.1.0更新於 Oct 4, 2026

Japan fuel prices by prefecture (METI weekly data). Tools: current, history, cheapest.

已驗證STDIO僅桌面FinanceData & Analytics

概覽

AI 產生的概覽

讓助理查詢日本各都道府縣的每週零售燃料價格，包括最新價格、歷史走勢與最便宜地區排名。

功能
提供日本資源能源廳（METI）每週汽油、柴油、煤油零售價格官方資料，涵蓋全國及 47 個都道府縣。工具包括：最新週均價（含週變化與汽油稅明細）、週度歷史（含最小值/最大值/平均值）、都道府縣最便宜至最貴排名、多產品全國趨勢，以及可查詢地區、產品與單位清單。都道府縣名稱支援漢字、羅馬字或加上都/府/県字尾。價格為含稅價，汽油與柴油為日圓/公升，煤油為日圓/18 公升。
適用情境
適合需要日本目前或歷史燃料價格資料的情境，例如比較各地價格、追蹤每週價格變化，或為預算、出行成本與總體分析提供燃料成本輸入。它是唯讀統計來源，不是加油站即時價格或購買工具。若需要日本以外價格或即時油價，則不適合。
執行需求
以 stdio 本機程序方式執行，透過 mcpb 套件散布，僅支援桌面端，沒有網頁可執行版本。依 README 的本機開發方式需要 Python 3、pip 及 requirements.txt 中的相依套件（openpyxl 用於解析 XLSX），並需要網路連線以瀏覽器 UA 抓取 METI 每週 XLSX 檔案。清單未宣告任何帳號、API 金鑰或環境變數；README 中選用的 Apify Standby 部署使用 APIFY_TOKEN 憑證。
安裝前請注意
README 中的 Apify Standby 部署範例使用 Authorization Bearer 憑證（APIFY_TOKEN），該權杖屬於敏感憑證，應只透過環境變數或請求標頭提供，不要寫入共用檔案。此伺服器只讀取 METI 公開統計，不會寫入、傳送或刪除使用者資料，也不涉及付款或錢包。請注意清單宣告本地封裝版本不需驗證、沒有環境變數，而 README 的託管路徑需要權杖，兩者要求不同。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Japan Fuel Price Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Japan Fuel Price MCP — METI Weekly Gasoline / Diesel / Kerosene

MCPサーバー: 日本のガソリン・軽油・灯油の週次小売価格を、資源エネルギー庁（METI）公式統計XLSXからAIエージェントに提供します。

  • データソース: 資源エネルギー庁 給油所小売価格調査 公式XLSX（毎週更新、1990年〜の全国・都道府県別平均現金価格）
  • 利用規約: 政府標準利用規約2.0（出典明示で商用利用可）
  • 単位: ガソリン・軽油 = 円/L、灯油 = 円/18L（消費税込み）

Tools

Tool説明
get_latest_fuel_price(prefecture, product)指定都道府県（または全国）の最新週平均価格 + 前週比 + ガソリン税内訳
get_fuel_price_history(prefecture, product, weeks)週次履歴（都道府県は直近260週、全国は1990年〜）+ min/max/avg
cheapest_prefectures(product, limit)47都道府県 最安〜最高値ランキング
national_fuel_trend(products, weeks)全国平均の複数製品トレンド（インフレ/マクロ指標用）
list_fuel_regions()照会可能な地域（漢字+ローマ字）・製品・単位のリスト

prefecture は漢字・ローマ字・「都/府/県」付きのいずれでも可（東京 / tokyo / 東京都）。北海道・沖縄はMETI調査の局単位データを都道府県として提供。

動作

  1. 初回呼び出しで最新 YYMMDDs5.xlsx を取得（ブラウザUA必須）、openpyxlでパースしJSONキャッシュ化
  2. 以後6時間はキャッシュから即答、TTL切れで新週ファイルをチェック
  3. METIのレート制限/障害時はビルド時同梱のシードキャッシュ（data/fuel_prices.json）にフォールバック — ツールが500になることはない

MCP接続

Apify Standby モード（streamable HTTP）:

https://api.apify.com/v2/acts/<ACTOR_ID>/mcpAuthorization: Bearer <APIFY_TOKEN>

ローカル開発

bash
pip install -r requirements.txtpython3 -m pytest tests/ -q          # 14 tests, network-stubbed, seed cachePORT=3999 python3 -m src.main &      # shim経由でApify SDK不要python3 tests/http_smoke.py http://localhost:3999/mcp

シード更新（週1回、木曜の公開後）:

bash
python3 scripts/refresh_seed.py          # METIから取得して data/fuel_prices.json 再生成python3 scripts/refresh_seed.py path/to/YYMMDDs5.xlsx   # 手元DL分から生成（レート制限回避）git add data/fuel_prices.json && git commit -m "data: seed refresh" && git push

Deploy

GitHub連携 Apify Actor（usesStandbyMode, webServerMcpPath=/mcp）。push後にビルドAPIを叩く:

bash
curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/builds?version=0.1&tag=latest&token=$APIFY_TOKEN"

出典表記

Source: Agency for Natural Resources and Energy (METI), Petroleum Products Price Survey. Government Standard Terms of Use 2.0.

來源：README.md，提交 7b804f4

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 4, 2026