97 lines
2.8 KiB
Markdown
97 lines
2.8 KiB
Markdown
---
|
||
name: cpc-price-cli
|
||
description: Query Taiwan CPC (中油) historical fuel prices via CLI. Use when user wants to check current or historical gas/fuel prices in Taiwan.
|
||
tools: Read, Glob, Grep, Bash
|
||
---
|
||
|
||
# CPC 油價查詢工具
|
||
|
||
查詢台灣中油（CPC）歷史油價的命令列工具，資料來源為[中油歷史油價頁面](https://www.cpc.com.tw/historyprice.aspx?n=2890)。
|
||
|
||
## 安裝
|
||
|
||
### Step 1: 安裝依賴
|
||
|
||
```bash
|
||
pip install requests beautifulsoup4
|
||
```
|
||
|
||
### Step 2: 下載腳本
|
||
|
||
```bash
|
||
# 下載腳本
|
||
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
|
||
```
|
||
|
||
## 使用方式
|
||
|
||
### 查詢油價
|
||
|
||
```bash
|
||
# 表格輸出（預設，顯示約 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 輸出
|
||
```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()` 函式。
|
||
|
||
## 更新
|
||
|
||
```bash
|
||
# 重新下載最新版本
|
||
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
|
||
```
|