台灣職籃資訊查詢

要解决什么问题

台湾职业篮球分散在 P. LEAGUE+（PLG） 与 台灣職業籃球大聯盟（TPBL） 两套官网与 API 里：赛程、战绩、排名、球员统计、单场 box score、即时比分与球员异动没有统一入口。归化球员与跨联盟译名（例如 PLG 的「吉爾貝克」与 TPBL 的「高柏鎧」）也会让按名字检索很容易落空。若还要查已结束的 T1 或奖项履历，官方接口往往覆盖不到。

技能如何工作

技能通过一组 CLI 脚本（uv run 管理依赖）按联赛拉取数据，并用 --league plg|tpbl|all 选择范围；--league all 时用 ThreadPoolExecutor 并行请求 PLG 与 TPBL，缩短等待时间。

• 数据来源：PLG 以服务端渲染 HTML 抓取；TPBL 走官方 REST API（api.tpbl.basketball）；台灣籃球維基館 经 Scrapling StealthyFetcher 绕过 Anubis（与 CPBL skill 共用 venv，不适合 web_fetch / Playwright）。
• 核心能力：赛程（含 --next 倒数）、战绩与 --stage 赛制过滤、排名、球员与排行榜（pts/reb/ast 等）、双人对比、即时比分、box score、交易异动、基于 SQLite 的 比赛提醒（~/.local/share/taiwan-basketball/basketball.db）。
• 数据质量：PLG 按赛季效力球队用三层机制（Preciser API → 经历区块 → 页面当前队）；球队名会规范化；TPBL 命中率由累计出手重算以保证跨 division 一致。结果默认 JSON，可用 -f table 出 ASCII 表；磁盘缓存位于 ~/.cache/taiwan-basketball/，--no-cache 可跳过。

边界与注意

• PLG 即时比分无官方 live API，仅在开赛时间 ±3 小时内估算进行中场次；精确比分仍建议看官网。
• 维基馆 启动慢（约 10～15 秒），且以外籍/归化球员页面不全为主；适合本土球员奖项、归化信息与跨联盟经历。
• SBL（超级篮球联赛） 不支持（站点为需认证的 GraphQL SPA）。