wnba-data

WNBA データ

クエリを作成する前に、エンドポイント、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 wnba get_scoreboard
sports-skills wnba get_standings --season=2025
sports-skills wnba get_teams

重要：クエリを実行する前に必ず確認

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

• シーズンの年は、システムプロンプトの currentDate から導き出してください。決してハードコードしないでください。
• チーム名だけが指定された場合は、チーム固有のコマンドを使う前に get_teams を呼び出してチーム ID を特定してください。

シーズンの選択

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

• ユーザーがシーズンを指定した場合は、そのまま使用してください。
• ユーザーが「現在の」「今シーズン」などと指定した場合、またはシーズンを指定しなかった場合：WNBA のシーズンは 5 月から 10 月です。現在の月が 5 月から 10 月なら season = current_year を使用してください。11 月から 4 月（オフシーズン）なら season = current_year - 1 を使用してください。

コマンド

コマンド	説明
get_scoreboard	WNBA のライブスコア／直近のスコア
get_standings	カンファレンス別の順位表
get_teams	WNBA の全チーム
get_team_roster	チームの全選手名簿
get_team_schedule	特定チームのスケジュール
get_game_summary	詳細なボックススコアと得点プレー
get_leaders	WNBA の統計リーダー
get_news	WNBA のニュース記事
get_play_by_play	試合の全プレー・バイ・プレー
get_win_probability	勝率チャートのデータ
get_schedule	特定の日付またはシーズンのスケジュール
get_injuries	全チームの負傷者情報
get_transactions	最近の移籍・取引
get_futures	先物／オッズ市場
get_team_stats	チームの統計プロフィール
get_player_stats	選手の統計プロフィール

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

例

例 1：今日のスコア ユーザー：「今日の WNBA のスコアは？」 操作：

1. get_scoreboard() を呼び出す 結果：ライブ中および直近の WNBA の全試合と、そのスコアおよび状況

例 2：順位表 ユーザー：「WNBA の順位表を見せて」 操作：

1. currentDate からシーズンの年を導き出す
2. get_standings(season=<derived_year>) を呼び出す 結果：東西カンファレンスの順位表と、勝敗、勝率、ゲーム差

例 3：チームの選手名簿 ユーザー：「インディアナ・フィーバーの選手は誰？」 操作：

1. get_team_roster(team_id="5") を呼び出す 結果：インディアナ・フィーバーの全選手について、名前、ポジション、背番号を表示

例 4：統計リーダー ユーザー：「WNBA の統計リーダーを見せて」 操作：

1. currentDate からシーズンの年を導き出す
2. get_leaders(season=<derived_year>) を呼び出す 結果：統計カテゴリ（得点、リバウンド、アシストなど）別のランキング

例 5：優勝オッズ ユーザー：「WNBA の優勝オッズは？」 操作：

1. get_futures(limit=10) を呼び出す 結果：優勝候補上位のチームとオッズ値

例 6：選手の統計 ユーザー：「エイジャ・ウィルソンの成績を見せて」 操作：

1. currentDate からシーズンの年を導き出す
2. get_player_stats(player_id="3149391", 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 を使用してください。

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

エラー処理

コマンドが失敗した場合、生のエラーをユーザーに表示しないでください。代わりに、次の手順に従ってください。

1. エラーを表に出さずに捕捉し、別の方法を試します
2. チーム名が指定され、ID が指定されていない場合は、まず get_teams を使って ID を確認します
3. 代替手段をすべて試した後にのみ、わかりやすいメッセージで失敗を報告します

トラブルシューティング

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

エラー：ID でチームが見つかりません 原因：誤った、または古い ESPN チーム ID が使われています 解決策：get_teams を呼び出して、ID を含むすべての WNBA チームの最新リストを取得します

エラー：今後の試合のデータが返されません 原因：ESPN が返すのは、終了した試合または進行中の試合のデータのみです 解決策：get_schedule を使って今後の試合の詳細を確認します。get_scoreboard の対象は、進行中または最近の試合のみです

エラー：オフシーズン（11月〜4月）にスコアボードが0件のイベントを返します 原因：オフシーズン中は試合が予定されていません 解決策：代わりに get_standings(season=<prior_year>) または get_news を使います