台湾职业排球联盟信息查询

它解决什么问题

查询 TPVL 比赛信息时，官网 /api/* 接口可能返回 401，直接写爬虫又要重复解析页面。tpvl 把常用查询封装成脚本，从 TPVL 官网的 __NEXT_DATA__ SSR JSON 中读取 赛果、赛程 和 积分榜。

技能如何工作

• 使用 uv run 管理依赖，自动安装 requests、lxml 等运行库。
• tpvl_games.py 从赛程页读取已完成比赛。
• tpvl_schedule.py 组合首页与赛程页，获取近期与后续比赛。
• tpvl_standings.py 从记录页读取球队积分与详细数据。
• tpvl_stats.py 会尝试自动探测球员数据页；如果页面仍是 404，则返回空数据而不是报错。

数据会缓存 30 分钟在 /tmp/tpvl_cache/，球队名支持别名过滤，例如 台鋼、連莊、伊斯特、桃園。

适用边界

• 当前只覆盖官网已开放的例行赛数据，没有明确季后赛或总冠军赛筛选。
• 球员数据属于 Coming Soon，可用性取决于 TPVL 页面是否开放。
• 适合学习与个人使用，应遵守 TPVL 服务条款，不用于绕过官网限制。