- name
- cpbl
- description
- Query CPBL 中華職棒 scores schedules live games standings player stats news and Taiwan baseball history for Taiwan users Use when the user asks about CPBL 戰績 賽程 即時比分 球員數據 排行榜 新聞 年度獎項 二軍 熱身賽 總冠軍賽 or historical CPBL facts
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
- 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.mdbefore assuming the data does not exist.
Script map
scripts/cpbl_live.py即時比分 今日賽況 指定日期賽況scripts/cpbl_games.py已完賽結果 歷史比賽scripts/cpbl_schedule.py賽程scripts/cpbl_standings.py戰績 排名scripts/cpbl_stats.py球員與排行榜數據
Common commands
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 10Game type codes
A一軍例行賽 預設B一軍明星賽C一軍總冠軍賽D二軍例行賽E一軍季後挑戰賽F二軍總冠軍賽G一軍熱身賽H未來之星邀請賽X國際交流賽
Live score notes
- Live data is polled from the official source and is not push-based.
- API data may lag by a few minutes.
- When
PresentStatusshows "比賽中" but/box/getlivereturnsGameStatus=3, the script corrects the status to "已結束" automatically. - Finished games now include detailed Box Score: pitcher lines (IP/H/ER/K/BB/HR/H/SV/speed) and key batter lines (AB/H/RBI/HR/R/SB).
- Game duration is displayed in
Xh Xmformat (e.g. 3h23m). - 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
uv run skills/cpbl/scripts/cpbl_schedule.py --month YYYY-MM --allPostponement info
To check today's postponement announcements, fetch the official news page:
https://cpbl.com.tw/newsLook 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
https://twbsball.dils.tku.edu.tw/wiki/index.php?title=關鍵字Common pages
中華職棒年度最有價值球員中華職棒年度新人王球員姓名
References
Read these only when needed
references/api-endpoints.mdofficial-site endpoint behavior and quirksreferences/summary.mdproject background and current limitationsreferences/test-report.mdprior 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.