NCAA越野与田径数据查询

要解决的问题

NCAA 越野和田径的数据分散在 TFRRS 的各个页面里。想知道某个运动员的个人最好成绩（PR），得打开她/他的 TFRRS profile 一页一页翻；想看整个赛季的越野成绩，就得把每场 meet 的结果手动拼起来；想看团队名单，还得先找到对应队伍的页面。对需要批量或重复查询的人——比如写报道、做分析、或者只是想快速对比几位跑者——每次都靠浏览器手动翻太慢了。

另外，The Stride Report 是一个聚合大学田径与越野新闻的 RSS 源，但要拉取最新文章也需要单独处理 feed。

技能如何工作

这个技能封装了 TFRRS 公开页面和 The Stride Report RSS，提供 CLI 和 Python SDK 两种调用方式。

核心思路是：所有查询都基于从 TFRRS URL 提取的标识符。运动员 profile 由三个参数定位：

• athlete_id：数字 ID，如 9230145
• school：学校 slug，用下划线不用空格，如 BYU
• name：运动员姓名 slug，如 Jane_Hedengren

这三个参数必须与 TFRRS 页面 URL 完全一致（区分大小写）。典型流程是：

1. 先调 search_athlete 按姓名搜索当前在队的运动员，拿到三个参数
2. 再用这些参数调 get_athlete_profile，拿回 PR 和按赛季分组的 meet 成绩
3. 如果想按赛季过滤，需要在返回的 data.meets 里按日期筛选

其余命令各司其职：get_team_roster 拉队伍名单，get_meet_results 按 meet_id 和 slug 拿整场赛事的成绩与团队积分，get_news 从 The Stride Report 拉最近的文章。

对已毕业或转学的运动员，search_athlete 只会返回空结果——这是设计如此，不是 bug。此时需要用户提供该运动员的 TFRRS URL，从 URL 里解析出参数再查。另外 TFRRS 会把 XC 和 TF 分成两个独立 profile，两边都存在时需要分别拉取才能拿到完整 PR。

适用边界与注意点

• 只搜当前在队的运动员。毕业、转学、毕业多年的运动员搜不到，必须走 URL 解析路线。
• slug 严格区分大小写。BYU 不是 byu，UC_Davis 不是 UC Davis。写错会 404 或查不到。
• 命令表里没有的就是不存在。get_team_rankings、search_athletes、fetch_news 这些名字看着合理，但技能里没有，别猜。
• 请求会限流到每秒 1 次。批量拉取时如果遇到连接超时，等几秒再重试，不要连打。
• prs 可能返回空字典。新 profile 或者页面结构不同的运动员可能拿不到 PR，需要去 TFRRS 直接看。
• get_news 依赖第三方 RSS。The Stride Report 挂了的话这个命令也拿不到数据，技能本身没办法绕过。