360 Secure SkillHub
360 安全技能中心

cpbl

以內建 Python 腳本查詢中華職棒官方的即時比分、賽程、戰績、球員與進階 Statcast 數據，並用 Scrapling StealthyFetcher 抓取台灣棒球維基館的獎項與球員歷史資料；支援文字與 JSON 輸出，資料為輪詢取得，可能延遲數分鐘。

ichendong
ichendong
热度 64.55
最近更新 2026-09-04 23:15:39
分类：搜索依赖：代码执行 / 联网浏览搜索 / 读写文件 / 第三方 API应用场景：研究 / 数据处理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add cpbl
Metadata
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
metadata
{"openclaw":{"emoji":"⚾","requires":{"bins":["uv"],"anyBins":["python3"]},"clawhub":{"link":"https://clawhub.ai/ichendong/cpbl"}}}

CPBL

Use the bundled scripts for official-site data first. Use web_search for recent news. Use Scrapling StealthyFetcher for 台灣棒球維基館 (awards history, player career data) — the site uses Anubis protection that blocks standard fetch tools, but Scrapling's stealth browser can access it. Do NOT use web_fetch or Playwright for twbsball — they will be blocked by Anubis.

Primary workflow

  1. Pick the narrowest script that matches the request.
  2. Prefer text output for user-facing answers and JSON output for chaining or debugging.
  3. If the official source cannot provide the requested historical fact, use Scrapling StealthyFetcher to fetch 台灣棒球維基館.
  4. 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 即時比分 今日賽況 指定日期賽況
  • scripts/cpbl_games.py 已完賽結果 歷史比賽
  • scripts/cpbl_schedule.py 賽程
  • scripts/cpbl_standings.py 戰績 排名
  • scripts/cpbl_stats.py 球員與排行榜數據
  • scripts/cpbl_advanced.py 進階數據（stats.cpbl.com.tw Statcast 級）

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 10

### 進階數據（stats.cpbl.com.tw，2026-09-04 新增）

```bash
# 擊球初速 × 仰角排行（打者）
uv run skills/cpbl/scripts/cpbl_advanced.py leaderboard exit-velocity --type batter --year 2026
# 球種球速轉速（投手）
uv run skills/cpbl/scripts/cpbl_advanced.py leaderboard pitch-tracking --type pitcher --year 2026
# wOBA/AVG/SLG PR 百分位
uv run skills/cpbl/scripts/cpbl_advanced.py leaderboard pr-table --type batter --year 2026
# 擊球彈道分布 + 過濾（月份/球隊/守位/球種）
uv run skills/cpbl/scripts/cpbl_advanced.py leaderboard batted-ball --type batter --year 2026 --team 兄弟 --position SS
# 聯盟年度總覽
uv run skills/cpbl/scripts/cpbl_advanced.py summary --year 2026
# 單一球員逐球紀錄（Trackman 球速轉速）
uv run skills/cpbl/scripts/cpbl_advanced.py logs --player 曾子祐 --year 2026 --limit 10
# 球員基本資料
uv run skills/cpbl/scripts/cpbl_advanced.py info --player 魔鷹

Game type codes

  • A 一軍例行賽 預設
  • B 一軍明星賽
  • C 一軍總冠軍賽
  • D 二軍例行賽
  • E 一軍季後挑戰賽
  • F 二軍總冠軍賽
  • G 一軍熱身賽
  • H 未來之星邀請賽
  • X 國際交流賽

Advanced stats API (stats.cpbl.com.tw)

2026-09-04 整合官方進階數據站（Statcast 級，Trackman 資料）。所有端點經 /api/proxy/v1/...，直接 HTTP GET（需 User-Agent + Content-Type: application/json header），無需登入或 CSRF token。

可用端點：

  • /v1/leaderboards/exit-velocity — 擊球初速（EvAvg/EvMax/Ev90th）、仰角（LaAvg）、HardHit%、Barrels
  • /v1/leaderboards/batted-ball — 滾地/飛球/平飛/內飛/高飛比例（Gbp/Airp/Fbp/Ldp/Pup）
  • /v1/leaderboards/pitch-tracking — 球種（fastball/breakingball/細分）、均速極速（Kph/KphMax）、轉速（SpinRate/SpinRateMax）
  • /v1/leaderboards/pr-table — wOBA/AVG/SLG + PR 百分位
  • /v1/leaderboards/summary — 聯盟年度總覽（需 gameKind + year）
  • /v1/players/{acnt} — 球員基本資料（Basic/Rmk 經歷）
  • /v1/players/logs — 逐球紀錄（需 playerType/acnt/year/kindCode；含 Trackman Pitch.Release 的 RelSpeed/SpinRate/Extension）
  • /v1/players/autocomplete — 球員搜尋（回 Acnt）

filter 參數：searchType(batter/pitcher)、gameKind(A~X)、year、month(1-12)、teamCode、opponentTeamCode、defendStationCode(P/C/1B/2B/3B/SS/LF/CF/RF/DH/PH)、batSide、pitchHand、fieldAbbe(F04=台南/F08=新莊/F19=洲際/F29=大巨蛋...)、pitchType、playerAcnt。空值參數會被 API 忽略，可省略。

⚠️ 注意：pitch-tracking 的 --type 不影響結果（預設即投手球種資料）；searchType 只對 exit-velocity/batted-ball/pr-table 有意義。

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 PresentStatus shows "比賽中" but /box/getlive returns GameStatus=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 Xm format (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 --all

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

台灣棒球維基館 (twbsball) 自 2026-05 起啟用 Anubis v1.25.0 防護機制。 web_fetch、tavily_extract、Playwright 無法存取該站。 使用 Scrapling StealthyFetcher 可以正常存取（已驗證）。

查詢維基館的方法（優先順序）

  1. Scrapling StealthyFetcher — 使用 CPBL venv 裡的 scrapling 直接抓取維基館頁面（已驗證可用）
  2. web_search / tavily_search — 搜尋引擎快照
  3. 維基百科 (zh.wikipedia.org)
  4. 請使用者手動查詢

Scrapling 查詢維基館

CPBL 腳本皆為 PEP 723 inline script，uv run 會自動處理依賴，不需手動建 venv 或 pip install。 不要用 web_fetch 或 Playwright。

安裝（首次使用前）：

# 唯一需要手動裝的：patchright browser（StealthyFetcher 底層依賴）
# 利用 cpbl_games.py 等腳本已有的 scrapling[ai] 依賴
cd skills/cpbl && uv run --with "scrapling[ai]" --with curl_cffi patchright install

使用 cpbl_twbsball.py（推薦）：

uv run skills/cpbl/scripts/cpbl_twbsball.py "中華職棒年度最有價值球員"
uv run skills/cpbl/scripts/cpbl_twbsball.py "陳鏞基" --output json

或直接在 Python 中使用：

from scrapling.fetchers import StealthyFetcher

page = StealthyFetcher.fetch(
    "https://twbsball.dils.tku.edu.tw/wiki/index.php?title=中華職棒年度最有價值球員",
    headless=True,
    wait=10000,
)
text = page.css("#mw-content-text")[0].get_all_text()
print(text)

注意事項：

  • wait=10000 (毫秒) 讓 Anubis PoW 挑戰完成，頁面載入後才抓
  • headless=True 即可，不需 headful
  • 啟動較慢（要啟動 stealth browser），約需 10-15 秒
  • 如果要查多個頁面，使用 StealthySession 複用同一個 browser 實例：
from scrapling.fetchers import StealthySession

with StealthySession(headless=True) as session:
    page1 = session.fetch("https://twbsball.dils.tku.edu.tw/wiki/index.php?title=中華職棒年度最有價值球員")
    text1 = page1.css("#mw-content-text")[0].get_all_text()
    page2 = session.fetch("https://twbsball.dils.tku.edu.tw/wiki/index.php?title=中華職棒年度最佳新人獎")
    text2 = page2.css("#mw-content-text")[0].get_all_text()

常用維基館頁面

  • 中華職棒年度最有價值球員 (MVP)
  • 中華職棒年度最佳新人獎 (新人王)
  • 球員姓名 (球員生涯資料)
  • URL 格式：https://twbsball.dils.tku.edu.tw/wiki/index.php?title=頁面標題

References

Read these only when needed

  • references/api-endpoints.md official-site endpoint behavior and quirks
  • references/summary.md project background and current limitations
  • references/test-report.md 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.
  • 台灣棒球維基館 (twbsball) 自 2026-05 起啟用 Anubis 防護機制。 web_fetch/Playwright 無法存取，使用 Scrapling StealthyFetcher 可以正常讀取（見上方 History and awards 段落）。