mcpField
C
cfb-data

cfb-data

github.com/machina-sportsデータ・データベース261696 回インストール今日更新
リポジトリ

cfb-data について

cfb-dataは、sports-skills CLIで大学アメリカンフットボールのスコア、ランキング、チーム、試合情報を調べるスキルです。NCAA公式エンドポイントを使い、FBS・FCSや各ディビジョンの学校情報も扱います。

主な機能

  1. 01スコア、日程、カンファレンス順位の取得
  2. 02ロスターとチーム・選手統計の参照
  3. 03試合概要とプレーごとの記録の確認
  4. 04負傷情報、ニュース、先物市場の確認
  5. 05NCAA経由でFBS・FCS・学校データを検索

活用シーン

  1. 01今週の大学アメフトのスコア確認
  2. 02カンファレンス順位やチーム日程の検索
  3. 03チームや選手のシーズン統計の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/machina-sports/sports-skills --skill cfb-data

インストール後、Claude Code で/cfb-dataを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
api-reference.md
conference-ids.md
team-ids.md
scripts/
validate_params.sh

詳細

カレッジフットボールデータ（CFB）

クエリを作成する前に、エンドポイント、カンファレンス ID、チーム ID、データ構造について references/api-reference.md を参照してください。

セットアップ

初めて使用する前に、CLI が利用可能か確認してください：

which sports-skills || pip install sports-skills

pip install が Python のバージョンエラーで失敗する場合、このパッケージには Python 3.10 以降が必要です。互換性のある 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

API キーは不要です。

クイックスタート

Python のインポートパスの問題を回避できるため、CLI を優先してください：

sports-skills cfb get_scoreboard
sports-skills cfb get_rankings
sports-skills cfb get_standings --group=8

重要：クエリを実行する前に

重要：データエンドポイントを呼び出す前に、以下を確認してください：

  • シーズンの年はシステムプロンプトの currentDate から導き出してください。ハードコードしないでください。
  • 順位表では、group パラメーターに正しいカンファレンス ID を設定してください（references/api-reference.md を参照）。
  • チーム名しか指定されていない場合は、get_teams を使ってチーム ID を特定してください。

シーズンの選択

システムプロンプトの日付から現在の年を導き出してください（例：currentDate: 2026-02-28 → 現在の年は 2026 年です）。

  • ユーザーがシーズンを指定した場合は、そのまま使用してください。
  • ユーザーが「現在」「今シーズン」と指定した場合、またはシーズンを指定していない場合：CFB のシーズンは 8 月から 1 月までです。現在の月が 2 月から 7 月（オフシーズン）の場合は、season = current_year - 1 を使用してください。8 月以降は現在の年を使用してください。

重要：カレッジとプロの違い

  • 順位表はカンファレンスごとです。group パラメーターを使って絞り込んでください。
  • ランキングはリーダー情報の代わりです。カレッジでは AP Top 25、Coaches Poll、CFP ランキングを使用します。
  • ランク入りチームにはスコアボードの対戦チーム情報に rank フィールドがあります（null はランク外を意味します）。
  • 週単位のスケジュールです。NFL と同様に、カレッジフットボールでは週番号を使用します。

コマンド

コマンド説明
get_scoreboardカレッジフットボールのライブ／最近のスコア
get_standingsカンファレンス別の順位表（group パラメーターを使用）
get_teams750 以上の FBS カレッジフットボールチームすべて
get_team_rosterチームの全ロースター
get_team_schedule特定チームのスケジュール
get_game_summary詳細なボックススコアと得点プレー
get_rankingsAP Top 25、Coaches Poll、CFP ランキング
get_newsカレッジフットボールのニュース
get_play_by_play試合の全プレーバイプレー
get_win_probability終了した試合の勝率推移
get_schedule週別のシーズンスケジュール
get_injuries全チームの負傷者情報
get_futures先物／オッズ市場（ナショナル・チャンピオンシップ、ハイズマン賞など）
get_team_statsチームの統計プロフィール
get_player_stats選手の統計プロフィール
get_ncaa_scoreboard公式 NCAA スコアボード — FBS および FCS
get_ncaa_schedule試合がある週（公式インデックス）
get_ncaa_game公式 NCAA 試合情報
get_ncaa_boxscore公式 NCAA ボックススコア
get_ncaa_play_by_playドライブの状況を含む公式プレーバイプレー
get_ncaa_scoring_summary公式得点サマリー
get_ncaa_schoolsNCAA 学校インデックス（全ディビジョン）

パラメーターと戻り値の形式の全一覧は、references/api-reference.md を参照してください。

公式 NCAA バックエンド

get_ncaa_* コマンドは NCAA 独自のエンドポイント（sdataprod.ncaa.com + ncaa.com）を読み取ります。ESPN がカバーしていない範囲も対象です。

  • division="fcs" による FCS のスコアボード — ESPN のカレッジフットボールの報道は FBS 中心です。
  • 公式の試合詳細：get_ncaa_game、get_ncaa_boxscore、 get_ncaa_play_by_play（ドライブのコンテキスト付き）、get_ncaa_scoring_summary。
  • 学校のインデックス（全ディビジョンで約 1,200 校）：get_ncaa_schools。

NCAA の試合 ID（例：get_ncaa_scoreboard から取得する 6306261）と ESPN のイベント ID には共通点がありません。試合日とチーム名で照合してください。NCAA は試合 ID を再発行するため、 保存して使い回すのではなく、毎回 get_ncaa_scoreboard を呼び出して最新の ID を取得してください。 フットボールのディビジョンは fbs／fcs であり、d1-d3 ではありません。get_ncaa_schedule は get_ncaa_scoreboard に渡す週番号を返します（16 以降はポストシーズンで、FCS プレーオフも 含まれます）。スコアリングサマリーのフィールドゴールには、プレーごとのデータから取得した distance_yards が含まれます。get_ncaa_schools を除くすべての get_ncaa_* コマンドは、 NCAA の GraphQL 永続クエリを使用します。そのハッシュは ncaa.com の再デプロイ時に変更されます。 変更が発生した場合はその旨が明示されます。また、ESPN ベースの get_scoreboard／ get_schedule で同じ FBS の試合をカバーできます。

使用例

例 1：現在のランキング ユーザーの発言：「カレッジフットボールのランキングは？」 アクション：

  1. get_rankings() を呼び出す 結果：順位、前回の順位、戦績を含む AP Top 25、Coaches Poll、CFP のランキング

例 2：カンファレンスの順位表 ユーザーの発言：「SEC のフットボール順位表を見せて」 アクション：

  1. currentDate からシーズン年を算出する
  2. get_standings(group=8, season=<derived_year>) を呼び出す（group 8 = SEC） 結果：チームごとの勝敗記録を含む SEC の順位表

例 3：チームのスケジュール ユーザーの発言：「今シーズンのアラバマのスケジュールは？」 アクション：

  1. currentDate からシーズン年を算出する
  2. get_team_schedule(team_id="333", season=<derived_year>) を呼び出す 結果：対戦相手、日付、スコア（試合終了後）を含むアラバマのシーズン全日程

例 4：週間スコア ユーザーの発言：「今週のカレッジフットボールのスコアを見せて」 アクション：

  1. get_scoreboard() を呼び出す 結果：スコアとランキング状況を含む、開催中および最近の CFB の全試合

例 5：ハイズマン賞の有力候補 ユーザーの発言：「ハイズマン賞の本命は誰？」 アクション：

  1. get_futures(limit=10) を呼び出す 結果：オッズの値を含む、ハイズマン賞の有力候補上位

例 6：チームの統計 ユーザーの発言：「アラバマのチーム統計を見せて」 アクション：

  1. currentDate からシーズン年を算出する
  2. get_team_stats(team_id="333", season_year=<derived_year>) を呼び出す 結果：カテゴリ別の数値、順位、1 試合あたりの平均を含むアラバマのシーズン統計

存在しないコマンド — 絶対に呼び出さないでください

  • get_odds／get_betting_odds — 利用できません。予測市場のオッズには polymarket または kalshi のスキルを使用してください。
  • search_teams — 存在しません。代わりに get_teams を使用してください。
  • get_box_score — 存在しません。代わりに get_game_summary を使用してください。
  • get_player_ratings — 存在しません。代わりに get_player_stats を使用してください。
  • get_bcs_rankings／get_playoff_rankings — 存在しません。代わりに get_rankings を使用してください。

上記のコマンド表に記載されていないコマンドは存在しません。

エラー処理

コマンドが失敗しても、生のエラーをユーザーに提示しないでください。代わりに：

  1. 指定日の試合が見つからない場合は、オフシーズンかどうかを確認します（CFB の開催期間は 8 月～1 月です）。
  2. グループを指定せずに順位表が空の場合は、特定のカンファレンスグループを指定して試します。
  3. 代替手段を試し尽くした後に限り、わかりやすいメッセージで失敗を伝えます。

トラブルシューティング

エラー：sports-skills コマンドが見つかりません 原因：パッケージがインストールされていません 解決策：pip install sports-skills を実行してください

エラー：試合が見つかりません 原因：CFB はシーズン制です（8 月～1 月）。シーズンオフのスコアボードは空になります 解決策：年間を通して get_rankings または get_news を使用してください。シーズン開始時期を確認するには get_schedule を使用してください

エラー：チームが多すぎます 原因：get_teams は 750 以上の FBS チームを返します 解決策：references/api-reference.md にある特定のチーム ID を提示して、ユーザーが絞り込めるようにしてください。または、ESPN の URL を使って ID を調べてください

エラー：シーズンオフにランキングが空です 原因：ランキングが発表されるのはシーズン中とシーズンオフの初期のみです 解決策：シーズンオフには get_news を使用してください。ランキングは 8 月に再開されます

コメント

Markdown 対応