cpc-price-cli/skill.md

name, description, tools

name	description	tools
cpc-price-cli	Query Taiwan CPC (中油) historical fuel prices via CLI. Use when user wants to check current or historical gas/fuel prices in Taiwan.	Read, Glob, Grep, Bash

CPC 油價查詢工具

查詢台灣中油（CPC）歷史油價的命令列工具，資料來源為中油歷史油價頁面。

安裝

Step 1: 安裝依賴

pip install requests beautifulsoup4

Step 2: 下載腳本

# 下載腳本
wget https://raw.githubusercontent.com/timmy/cpc-price-cli/main/cpc_price.py -O /usr/local/bin/cpc-price
chmod +x /usr/local/bin/cpc-price

# 或使用 curl
curl -o /usr/local/bin/cpc-price https://raw.githubusercontent.com/timmy/cpc-price-cli/main/cpc_price.py
chmod +x /usr/local/bin/cpc-price

使用方式

查詢油價

# 表格輸出（預設，顯示約 7 筆每週調價紀錄）
cpc-price

# 只顯示最新一筆
cpc-price --latest

# 日期轉西元年
cpc-price --ad

# CSV 輸出
cpc-price -f csv

# JSON 輸出
cpc-price -f json

# JSON + 西元年
cpc-price -f json --ad

參數說明

參數	說明
-f, --format	輸出格式：table（預設）、csv、json
--ad	將民國年份轉換為西元年份（民國年 + 1911）
--latest	只顯示最新一筆資料

輸出範例

表格輸出（預設）

┌────────────┬────────┬────────┬────────┬────────┐
│ 日期       │ 92無鉛 │ 95無鉛 │ 98無鉛 │ 超級   │
├────────────┼────────┼────────┼────────┼────────┤
│ 115/03/16  │ 28.8   │ 30.1   │ 32.1   │ 30.8   │
│ 115/03/09  │ 29.0   │ 30.3   │ 32.3   │ 31.0   │
│ 115/03/02  │ 29.4   │ 30.7   │ 32.7   │ 31.4   │
└────────────┴────────┴────────┴────────┴────────┘

JSON 輸出

[
  {"日期": "115/03/16", "92無鉛": "28.8", "95無鉛": "30.1", "98無鉛": "32.1", "超級": "30.8"},
  {"日期": "115/03/09", "92無鉛": "29.0", "95無鉛": "30.3", "98無鉛": "32.3", "超級": "31.0"}
]

注意事項

• 中油網站的 SSL 憑證缺少 Subject Key Identifier，因此使用 verify=False 略過驗證。
• 日期格式為民國年，例如 115/03/16，加上 --ad 後顯示為 2026/03/16。
• 若頁面 HTML 結構變動導致解析失敗，請檢查原始碼中的 fetch_prices() 函式。

更新

# 重新下載最新版本
wget https://raw.githubusercontent.com/timmy/cpc-price-cli/main/cpc_price.py -O /usr/local/bin/cpc-price
chmod +x /usr/local/bin/cpc-price