核心用法
CPBL 技能是中華職棒大聯盟（Chinese Professional Baseball League）屬數據查詢工具，涵蓋即時比分（cpbl_live.py）、賽程查詢（cpbl_schedule.py）、戰績排名（cpbl_standings.py）、球員統計（cpbl_stats.py）、歷史賽果（cpbl_games.py）及新聞搜尋（cpbl_news.py）六大模組。支援一軍例行賽、二軍、熱身賽、總冠軍賽、明星賽等多種賽事類型，並可透過 --date、--team、--year、--month 等參數精確篩選。
顯著優點
- 數據來源權威：優先調用中華職棒官方網站 API，確保即時比分、戰績排名的即時性與準確性
- 歷史資料補充：當官方數據不足時，自動銜接「台灣棒球維基館」查詢年度 MVP、新人王、球員生涯紀錄等深度資料
- 多層級賽事支援：完整覆蓋一軍、二軍、熱身賽、季後、國際交流賽等全賽事生態
- 快取機制：賽程資料採用本地快取（
memory/cpbl_schedule_YYYY.md），減少重複調用、提升回應速度
潛在缺點與局限性
- 即時性落差：官方 API 採輪詢機制，Live 數據可能存在數分延遲，非真正的推播即時
- 結構化風險：部分官方端點回傳 HTML 片段而非純 JSON，需額外解析；戰績與賽程流程因網站採用 AJAX+CSRF 保護，較為脆弱易失效
- 周一賽事空白：例行賽程周一通常無賽事，使用者查時可能得到空結果
- 數據缺漏處理：若官方回傳部分資料，系統不會自動填補缺失值，需明確告知限制並建議替代來源
適合人群
- 中華職棒球迷：需追蹤即時比分、賽程、戰績的日常使用者
- 運動數據分析者：需要批次下載歷史賽果、球員排行榜進行統計研究
- 棒球內容創作者：查詢年度獎項、歷史紀錄、球員生涯資料用於專題製作
常規風險
- 來源單點故障：若中華職棒官網維護或改版，可能導致全線腳本失效
- 第三方依賴：台灣棒球維基館屬社群維護，資訊正確性與更新頻率不如官方穩定
- 個資與版權：球員數據雖屬公開資訊，但大量爬取時需注意官方網站使用條款與 robots.txt 限制