核心用法
CPBL 技能是中華職棒（中華職業棒球大聯盟）專屬數據查詢工具，設計目標是為台灣用戶提供即時且全面的棒球資訊。主要功能分為六大腳本模組：
- 即時比分 (
cpbl_live.py)：查詢當日或指定日期賽況，含 Live 狀態自動校正與詳細 Box Score（投手數據、打者關鍵數據、球速） - 賽程查詢 (
cpbl_schedule.py)：預覽未來賽事，支援月曆檢視與快取機制 - 歷史戰績 (
cpbl_games.py)：檢索已完賽結果，可指定年度與筆數限制 - 球隊排名 (
cpbl_standings.py)：即時戰績排行榜 - 球員數據 (
cpbl_stats.py)：年度排行榜（打擊/投手），支援 TOP N 篩選
特殊功能
- 賽事類型完整支援：例行賽、熱身賽、季後挑戰賽、總冠軍賽、二軍賽事、明星賽、國際交流賽
- 延賽自動偵測：透過官方新聞面檢查封鎖公告，腳本能識別 0:0 無勝敗投手的延期賽事
- 歷史資料補強：當官方 API 無法提供年度獎項（MVP、新人王）、球員生涯紀錄時，自動導向台灣棒球維基館擷取
顯著優點
1. 多源整合策略：優先使用官方 API 確保時效性，再以維基館與新聞搜尋補充歷史與即時突發資訊
2. 輸出格式彈性：支援純文字（使用者導向）與 JSON（串接/除錯）雙模式
3. 即時數據校正：自動處理 API 狀態延遲（如比賽已結束但標示仍為進行中）
4. 本地化設計：針對台灣用戶習慣，完整支援繁體中文球隊名稱與中華職棒特殊賽制
潛在缺點與局限性
- 官方 API 不穩定：部分端點回傳 HTML 片段而非 JSON，某些戰績與賽程流程因網站 AJAX+CSRF 機制而較脆弱
- 即時數據延遲：Live 數據為輪詢機制，非即時推播，可能落後數分鐘
- 數據缺漏原則：腳本不會編造缺失數據，若回傳不完整需手動切換替代來源
- 週一無賽事：官方賽程慣例，除非因假日或補賽調整
適合人群
- 中華職棒球迷需查詢即時比分、賽程規劃觀賽
- 運動媒體、部落客撰寫賽事分析需快速取得統計數據
- 棒球研究者查詢歷史獎項、球員生涯紀錄
- 開發者需串接中職數據進行二次應用
常規風險
- 來源依賴風險：核心數據繫於 cpbl.com.tw 官方網站可用性，若官網維護或改版可能暫時失效
- CSRF 驗證變動：官方網站若調整安全驗機制，部分需登入的查詢流程可能中斷
- 維基館資料時效性：歷史紀錄雖詳盡，但非即時更新，最新賽季資料可能缺漏