CPBL
Use the bundled scripts for official-site data first.
Use web_search for recent news.
Use web_fetch on 台灣棒球維基館 for awards history or facts the official site does not expose.
Primary workflow
- 1. Pick the narrowest script that matches the request.
- Prefer text output for user-facing answers and JSON output for chaining or debugging.
- If the official source cannot provide the requested historical fact, fetch 台灣棒球維基館.
- If a result looks empty or partial, check
references/api-endpoints.md before assuming the data does not exist.
Script map
- -
scripts/cpbl_live.py 即時比分 今日賽況 指定日期賽況 - INLINECODE4 已完賽結果 歷史比賽
- INLINECODE5 賽程
- INLINECODE6 戰績 排名
- INLINECODE7 球員與排行榜數據
Common commands
CODEBLOCK0
Game type codes
- -
A 一軍例行賽 預設 - INLINECODE9 一軍明星賽
- INLINECODE10 一軍總冠軍賽
- INLINECODE11 二軍例行賽
- INLINECODE12 一軍季後挑戰賽
- INLINECODE13 二軍總冠軍賽
- INLINECODE14 一軍熱身賽
- INLINECODE15 未來之星邀請賽
- INLINECODE16 國際交流賽
Live score notes
- - Live data is polled from the official source and is not push-based.
- API data may lag by a few minutes.
- Inning detail may require opening
box_url or live_url. - Monday often has no games unless adjusted by holidays or makeup scheduling.
Schedule cache
If a request is about schedule, check memory/cpbl_schedule_YYYY.md first.
Refresh the cache when the file is missing, stale, or the requested range extends beyond the cached range.
Recommended refresh command
CODEBLOCK1
Postponement info
To check today's postponement announcements, fetch the official news page:
https://cpbl.com.tw/news
Look for the latest "延賽公告" entry. The live script now auto-detects postponed games (0:0 + no winning/losing pitcher).
History and awards
Use 台灣棒球維基館 for MVP 新人王 歷史紀錄 球員生涯資料 or older facts that the official site does not return.
Search URL format
CODEBLOCK3
Common pages
- - INLINECODE20
- INLINECODE21
- INLINECODE22
References
Read these only when needed
- -
references/api-endpoints.md official-site endpoint behavior and quirks - INLINECODE24 project background and current limitations
- INLINECODE25 prior investigation details
Known limits
- - Some official endpoints return HTML fragments instead of JSON.
- Some standings and schedule flows are brittle because the site relies on AJAX plus CSRF.
- If a script returns partial data, do not invent missing values. State the limit and fall back to another source when possible.
CPBL
優先使用官方網站提供的內建腳本獲取數據。
使用 web_search 查詢近期新聞。
使用 web_fetch 查詢台灣棒球維基館，以獲取官方網站未公開的獎項歷史或事實。
主要工作流程
- 1. 選擇最符合請求的特定腳本。
- 面向用戶的答案優先使用文字輸出，鏈式調用或除錯時使用 JSON 輸出。
- 若官方來源無法提供所請求的歷史事實，則查詢台灣棒球維基館。
- 若結果顯示為空或部分缺失，在假設數據不存在之前，請先檢查 references/api-endpoints.md。
腳本對照表
- - scripts/cpbllive.py 即時比分 今日賽況 指定日期賽況
- scripts/cpblgames.py 已完賽結果 歷史比賽
- scripts/cpblschedule.py 賽程
- scripts/cpblstandings.py 戰績 排名
- scripts/cpbl_stats.py 球員與排行榜數據
常用指令
bash
uv run skills/cpbl/scripts/cpbl_live.py --output text
uv run skills/cpbl/scripts/cpbl_live.py --date 2026-04-01 --team 兄弟
uv run skills/cpbl/scripts/cpbl_games.py --year 2025 --limit 10
uv run skills/cpbl/scripts/cpbl_schedule.py --month 2026-04 --all
uv run skills/cpbl/scripts/cpbl_standings.py
uv run skills/cpbl/scripts/cpbl_stats.py --year 2025 --category batting --top 10
比賽類型代碼
- - A 一軍例行賽 預設
- B 一軍明星賽
- C 一軍總冠軍賽
- D 二軍例行賽
- E 一軍季後挑戰賽
- F 二軍總冠軍賽
- G 一軍熱身賽
- H 未來之星邀請賽
- X 國際交流賽
即時比分說明
- - 即時數據是從官方來源輪詢獲取，非推送式。
- API 數據可能會有數分鐘的延遲。
- 局數細節可能需要打開 boxurl 或 liveurl 查看。
- 除非遇到假日調整或補賽，週一通常沒有比賽。
賽程快取
若請求涉及賽程，請先檢查 memory/cpblscheduleYYYY.md。
當檔案缺失、過期，或請求的範圍超出快取範圍時，請更新快取。
建議的更新指令
bash
uv run skills/cpbl/scripts/cpbl_schedule.py --month YYYY-MM --all
延賽資訊
若要查詢今日的延賽公告，請查詢官方新聞頁面：
https://cpbl.com.tw/news
尋找最新的「延賽公告」條目。即時腳本現在會自動偵測延賽的比賽（比分 0:0 且無勝敗投手）。
歷史與獎項
使用台灣棒球維基館查詢 MVP、新人王、歷史紀錄、球員生涯資料，或官方網站未提供的較舊事實。
搜尋網址格式
text
https://twbsball.dils.tku.edu.tw/wiki/index.php?title=關鍵字
常用頁面
- - 中華職棒年度最有價值球員
- 中華職棒年度新人王
- 球員姓名
參考資料
僅在需要時閱讀以下內容
- - references/api-endpoints.md 官方網站端點的行為與特殊情況
- references/summary.md 專案背景與當前限制
- references/test-report.md 先前的調查細節
已知限制
- - 部分官方端點回傳的是 HTML 片段而非 JSON。
- 部分戰績與賽程流程較不穩定，因為網站依賴 AJAX 和 CSRF。
- 若腳本回傳部分數據，請勿自行編造缺失值。請說明限制，並在可能的情況下轉用其他來源。
