cfb-data by machina-sports/sports-skills
npx skills add https://github.com/machina-sports/sports-skills --skill cfb-data在编写查询之前,请查阅 references/api-reference.md 以了解端点、联盟 ID、球队 ID 和数据格式。
首次使用前,检查 CLI 是否可用:
which sports-skills || pip install sports-skills
如果 pip install 因 Python 版本错误而失败,则该包需要 Python 3.10+。请找到兼容的 Python 版本:
python3 --version # 检查版本
# 如果版本 < 3.10,尝试:python3.12 -m pip install sports-skills
# 在 macOS 上使用 Homebrew:/opt/homebrew/bin/python3.12 -m pip install sports-skills
无需 API 密钥。
推荐使用 CLI —— 它可以避免 Python 导入路径问题:
sports-skills cfb get_scoreboard
sports-skills cfb get_rankings
sports-skills cfb get_standings --group=8
关键:在调用任何数据端点之前,请验证:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
currentDategroup 参数已设置为正确的联盟 ID(参见 references/api-reference.md)。get_teams 来解析球队 ID。从系统提示的日期推导当前年份(例如,currentDate: 2026-02-28 → 当前年份是 2026)。
season = current_year - 1。从八月开始,使用当前年份。group 参数进行筛选rank 字段(null = 未排名)| 命令 | 描述 |
|---|---|
get_scoreboard | 实时/近期的大学橄榄球比分 |
get_standings | 按联盟的排名(使用 group 参数) |
get_teams | 所有 750+ 支 FBS 大学橄榄球队 |
get_team_roster | 球队的完整阵容名单 |
get_team_schedule | 特定球队的赛程 |
get_game_summary | 详细的比赛统计数据和得分过程 |
get_rankings | AP Top 25、教练投票、CFP 排名 |
get_news | 大学橄榄球新闻 |
get_play_by_play | 比赛的完整逐场播放记录 |
get_schedule | 按周的赛季赛程 |
get_injuries | 所有球队的伤病报告 |
get_futures | 未来/赔率市场(全国冠军、海斯曼奖等) |
get_team_stats | 球队统计资料 |
get_player_stats | 球员统计资料 |
完整的参数列表和返回格式请参见 references/api-reference.md。
示例 1:当前排名 用户说:“大学橄榄球排名是什么?” 操作:
get_rankings()
结果:包含排名、上周排名、战绩的 AP Top 25、教练投票和 CFP 排名示例 2:联盟排名 用户说:“给我看看 SEC 橄榄球排名” 操作:
currentDate 推导赛季年份get_standings(group=8, season=<derived_year>)(group 8 = SEC)
结果:包含每支球队胜负记录的 SEC 排名示例 3:球队赛程 用户说:“阿拉巴马大学本赛季的赛程是什么?” 操作:
currentDate 推导赛季年份get_team_schedule(team_id="333", season=<derived_year>)
结果:阿拉巴马大学的完整赛季赛程,包含对手、日期、比分(如果已比赛)示例 4:每周比分 用户说:“给我看看这周的大学橄榄球比分” 操作:
get_scoreboard()
结果:所有实时和近期的 CFB 比赛,包含比分和排名状态示例 5:海斯曼奖热门人选 用户说:“谁是海斯曼奖的热门人选?” 操作:
get_futures(limit=10)
结果:前 10 名海斯曼奖候选人及其赔率值示例 6:球队统计数据 用户说:“给我看看阿拉巴马大学的球队统计数据” 操作:
currentDate 推导赛季年份get_team_stats(team_id="333", season_year=<derived_year>)
结果:按类别划分的阿拉巴马大学赛季统计数据,包含数值、排名和场均平均值get_oddsget_betting_oddssearch_teamsget_teams。get_box_scoreget_game_summary。get_player_ratingsget_player_stats。get_bcs_rankingsget_playoff_rankingsget_rankings。如果某个命令未在上面的命令表中列出,则它不存在。
当命令失败时,不要向用户显示原始错误信息。相反:
错误:sports-skills 命令未找到
原因:包未安装
解决方案:运行 pip install sports-skills
错误:未找到比赛
原因:CFB 是季节性的(八月至一月);休赛期的记分板将是空的
解决方案:全年使用 get_rankings 或 get_news;使用 get_schedule 查找赛季开始时间
错误:返回的球队过多
原因:get_teams 返回 750+ 支 FBS 球队
解决方案:通过建议使用 references/api-reference.md 中的特定球队 ID 来帮助用户缩小范围,或使用 ESPN URL 查找 ID
错误:休赛期排名为空
原因:排名仅在赛季和休赛期早期发布
解决方案:在休赛期使用 get_news;排名在八月恢复
每周安装量
90
仓库
GitHub Stars
55
首次出现
2026年2月20日
安全审计
安装于
opencode89
codex89
gemini-cli88
github-copilot87
cursor87
amp86
Before writing queries, consult references/api-reference.md for endpoints, conference IDs, team IDs, and data shapes.
Before first use, check if the CLI is available:
which sports-skills || pip install sports-skills
If pip install fails with a Python version error, the package requires Python 3.10+. Find a compatible Python:
python3 --version # check version
# If < 3.10, try: python3.12 -m pip install sports-skills
# On macOS with Homebrew: /opt/homebrew/bin/python3.12 -m pip install sports-skills
No API keys required.
Prefer the CLI — it avoids Python import path issues:
sports-skills cfb get_scoreboard
sports-skills cfb get_rankings
sports-skills cfb get_standings --group=8
CRITICAL: Before calling any data endpoint, verify:
currentDate — never hardcoded.group parameter is set to the correct conference ID (see references/api-reference.md).get_teams to resolve the team ID.Derive the current year from the system prompt's date (e.g., currentDate: 2026-02-28 → current year is 2026).
season = current_year - 1. From August onward, use the current year.group parameter to filterrank field (null = unranked) on scoreboard competitors| Command | Description |
|---|---|
get_scoreboard | Live/recent college football scores |
get_standings | Standings by conference (use group parameter) |
get_teams | All 750+ FBS college football teams |
get_team_roster | Full roster for a team |
get_team_schedule | Schedule for a specific team |
get_game_summary |
See references/api-reference.md for full parameter lists and return shapes.
Example 1: Current rankings User says: "What are the college football rankings?" Actions:
get_rankings() Result: AP Top 25, Coaches Poll, and CFP rankings with rank, previous rank, recordExample 2: Conference standings User says: "Show me SEC football standings" Actions:
currentDateget_standings(group=8, season=<derived_year>) (group 8 = SEC) Result: SEC standings with W-L records per teamExample 3: Team schedule User says: "What's Alabama's schedule this season?" Actions:
currentDateget_team_schedule(team_id="333", season=<derived_year>) Result: Alabama's full season schedule with opponent, date, score (if played)Example 4: Weekly scores User says: "Show me this week's college football scores" Actions:
get_scoreboard() Result: All live and recent CFB games with scores and ranked statusExample 5: Heisman favorites User says: "Who's the Heisman favorite?" Actions:
get_futures(limit=10) Result: Top Heisman Trophy candidates with odds valuesExample 6: Team statistics User says: "Show me Alabama's team stats" Actions:
currentDateget_team_stats(team_id="333", season_year=<derived_year>) Result: Alabama's season stats by category with value, rank, and per-game averagesget_oddsget_betting_oddssearch_teamsget_teams instead.get_box_scoreget_game_summary instead.get_player_ratingsget_player_stats instead.get_bcs_rankingsget_playoff_rankingsIf a command is not listed in the Commands table above, it does not exist.
When a command fails, do not surface raw errors to the user. Instead:
Error: sports-skills command not found Cause: Package not installed Solution: Run pip install sports-skills
Error: No games found Cause: CFB is seasonal (August–January); off-season scoreboard will be empty Solution: Use get_rankings or get_news year-round; use get_schedule to find when the season starts
Error: Too many teams returned Cause: get_teams returns 750+ FBS teams Solution: Help users narrow down by suggesting specific team IDs from references/api-reference.md, or use ESPN URLs to look up IDs
Error: Rankings empty in off-season Cause: Rankings are only published during the season and early off-season Solution: Use get_news in the offseason; rankings resume in August
Weekly Installs
90
Repository
GitHub Stars
55
First Seen
Feb 20, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode89
codex89
gemini-cli88
github-copilot87
cursor87
amp86
Lark CLI IM 即时消息管理工具:机器人/用户身份操作聊天、消息、文件下载
32,700 周安装
Nansen CLI:分析Polymarket交易员活动与盈亏的区块链工具
195 周安装
Skill Master - 创建、编辑和验证 Agent Skills 的完整工具包 | 遵循 agentskills.io 规范
109 周安装
Nansen Token Research CLI - 区块链代币深度分析工具,获取价格、持有者、资金流数据
207 周安装
ComfyUI视频生成管线:Wan/FramePack/AnimateDiff三引擎选择指南与优化教程
185 周安装
Instagram内容生成器 - AI驱动,一键生成符合格式的图片视频
199 周安装
滚动动画设计指南:迪士尼动画原则在滚动触发动效中的应用与实践
137 周安装
| Detailed box score and scoring plays |
get_rankings | AP Top 25, Coaches Poll, CFP rankings |
get_news | College football news |
get_play_by_play | Full play-by-play for a game |
get_schedule | Season schedule by week |
get_injuries | Injury reports across all teams |
get_futures | Futures/odds markets (National Championship, Heisman, etc.) |
get_team_stats | Team statistical profile |
get_player_stats | Player statistical profile |
get_rankings