CPBL 职棒数据与历史助手

解决的问题

中华职棒查询分散在官网接口、赛程缓存、新闻公告和维基馆历史页，普通抓取常被反爬或返回 HTML 片段。若直接用网页抓取处理「今日比分、某球员生涯、MVP 记录」，容易拿到空结果、过期数据或错误赛制。这类查询的质量取决于取数顺序、缓存策略与反爬处理，而不是单靠网页正文解析。

工作方式

• 优先调用内置脚本：scripts/cpbl_live.py 查实时比分，scripts/cpbl_games.py 查已完赛，scripts/cpbl_schedule.py 查赛程，scripts/cpbl_standings.py 查排名，scripts/cpbl_stats.py 查球员与排行。
• 官方源不足时，用 Scrapling StealthyFetcher 访问 twbsball 维基馆，处理奖项、年度 MVP、新人王和球员生涯页；避免 web_fetch 与 Playwright，因为 Anubis 防护会拦截普通请求。
• 对历史结果保持保守：脚本返回部分数据时不补造数值，必要时查 references/api-endpoints.md 或回退搜索引擎快照。

适用边界

• 实时数据是轮询而非推送，可能有几分钟延迟；GameStatus 与文字状态不一致时会按结束状态修正。
• 官网部分端点返回 HTML 片段，AJAX 与 CSRF 可能导致赛程、战绩流程脆弱。
• 周一常无赛事，除非假期调休；延赛需结合官网新闻与比分脚本判断。
• 若脚本为空或仅返回片段，应明确说明限制。