sports-scores-research

スポーツ・陸上競技のリサーチ

5つのスポーツデータソースから、ライブスコアボード、順位表、ロスター、選手／チームの統計、スポーツブックのオッズ、持久系スポーツのルート／クラブを、スクレイピングでスコアボードのウィジェットや統計ページを取得することなく、Crawlora API 経由で正規化された JSON として取得します。

ツールの対象範囲とデータフロー

任意で使用できるシェルヘルパーは、このスキルで実行を求める唯一のコマンドです。ドキュメントに記載され、許可リストに登録された Crawlora のルートにのみ GET リクエストを送信します。実行すると、CRAWLORA_API_KEY を読み取り、HTTPS 経由で api.crawlora.net に x-api-key ヘッダーとして送信します。キーを ESPN、SofaScore、Strava、その他のスポーツソースに送信することはありません。TMPDIR 内に権限 600 の curl 設定ファイルを一時的に作成し、コマンドの終了時に削除します。ほかの環境変数の調査、ファイルの列挙、ソフトウェアのインストール、昇格された権限での実行は行いません。クエリ、公開されているイベント／選手／チームの識別子、リクエストするルートは Crawlora に送信されるため、機密性の高いリサーチ対象は避けてください。

スコア／統計のエンドポイントに加えて、このスキルには Cricinfo と Sportskeeda の公開スポーツ関連記事、記事、Wiki、クイズ、動画の各コンテンツも含まれます。ユーザーのリクエストに関連する場合に限り、これらのソースを使用してください。Strava のルートやクラブの検索からは、位置情報に関わるトレーニングパターンが明らかになる可能性があります。誰かの自宅、習慣、または機微な位置履歴の推測には使用しないでください。

このスキルを使用する場合

• 「今の<試合>のスコア／状況は？」
• 「<チーム>のロスター／シーズン成績／順位を見せて。」
• 「今シーズンの<選手>の成績は？」
• 「<試合>のボックススコア／プレー・バイ・プレーを教えて。」
• 「<チーム A>と<チーム B>の直接対決の過去の成績は？」
• 試合後のサッカーの詳細なパフォーマンス概要には、football-match-performance-analysis がインストールされている場合はそちらを使用してください。このスキルは、一般的なスコア／統計の入口として引き続き使用できます。
• 公開されているリーグニュース、ランキング／投票、または賭けオッズのスナップショット。
• 「<試合>のオッズ／ハンディキャップ／合計点は？」または「<リーグ>優勝の先物オッズは？」（DraftKings Sportsbook）。
• 「<地域>のランニング／サイクリング／ハイキングのルートを探して」または「この Strava クラブを調べて。」

セットアップ（初回のみ）

• 無料の Crawlora API キー（カード不要、月 2,000 クレジット）を https://crawlora.net で取得します。
• ヘルパーを実行する前に、環境に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない場合、または無効な場合は 401 が返されます。

仕組み

1. ESPN（ほとんどのスポーツ／リーグ） — 今日または指定日の試合には /espn/scoreboard（スポーツとリーグのパラメーターを指定）、チーム一覧と詳細には /espn/teams / /espn/team、ロースターには /espn/team-roster、順位表には /espn/standings、選手情報には /espn/athlete、1 試合の対戦情報／オッズ／ボックススコアには /espn/game-summary、さらに /espn/news と /espn/rankings（例：AP Top 25）を利用します。
2. SofaScore（世界のサッカーを中心に、多数のスポーツに対応） — チーム／選手／イベントの ID を特定するには /sofascore/search、現在ライブ中のイベントには /sofascore/live-events を利用します。1 試合を詳しく調べるには /sofascore/event（および /event-statistics、/event-lineups、/event-incidents、/event-odds、/event-h2h）を利用します。ほかに /sofascore/standings、/sofascore/team、/sofascore/team-events、/sofascore/team-players、/sofascore/player があります。
3. MLB — 日付ごとの試合／スコアには /mlb/schedule、1 試合の詳細には /mlb/game（および /mlb/game-boxscore、/mlb/game-play-by-play）を利用します。ほかに /mlb/standings、/mlb/teams、/mlb/team-roster、/mlb/team-stats、/mlb/player と /mlb/player-stats、契約／トレード／IL への移動には /mlb/transactions、リーグのランキング上位選手には /mlb/league-stats があります。
4. Strava — ルートを検索するには /strava/routes を利用します。sport（hiking、road-biking、mountain-biking、trail-running、gravel-biking のいずれか）と、country および region のスラッグが必要です。1 つのルートには /strava/routes/detail（path）、クラブには /strava/clubs/{id}、現在公開中のチャレンジには /strava/challenges を利用します。
5. DraftKings Sportsbook — スポーツ／リーグ一覧を取得するには /draftkings/sportsbook/leagues を利用して league_id を取得し、その後 /draftkings/sportsbook/odds（league_id）で、今後開催されるすべてのイベントの勝敗予想／ハンディキャップ／合計得点を取得します。ライブイベントには /draftkings/sportsbook/live、1 つのイベントの市場全体の詳細には /draftkings/sportsbook/event（および subcategory_id を指定した /event-markets）、先物市場には /draftkings/sportsbook/futures（league_id と subcategory_id）を利用します。チームの検索には /draftkings/sportsbook/teams と /team を利用します。

すべてのエンドポイント、メソッド、パラメーターについては、reference/endpoints.md を参照してください。

API の呼び出し

# ESPN scoreboard + team:
scripts/crawlora.sh /espn/scoreboard sport=basketball league=nba | jq '.'
scripts/crawlora.sh /espn/team-roster sport=basketball league=nba team=lal | jq '.'

# SofaScore live + match detail:
scripts/crawlora.sh /sofascore/live-events sport=football | jq '.'
scripts/crawlora.sh /sofascore/event id=<event-id> | jq '.'

# MLB:
scripts/crawlora.sh /mlb/schedule date=2026-08-10 | jq '.'
scripts/crawlora.sh /mlb/player-stats id=<mlb-id> group=hitting | jq '.'

# Strava:
scripts/crawlora.sh /strava/challenges | jq '.'
scripts/crawlora.sh /strava/routes sport=hiking country=<country-slug> region=<region-slug> | jq '.'

# DraftKings Sportsbook odds:
scripts/crawlora.sh /draftkings/sportsbook/leagues | jq '.'
scripts/crawlora.sh /draftkings/sportsbook/odds league_id=<league-id> | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーをコマンドライン引数に含めずに済みます。

エンドポイントのリファレンス

このスキルが使用する ESPN、SofaScore、MLB、Strava、DraftKings Sportsbook のすべてのエンドポイントについては、reference/endpoints.md を参照してください。

使用例

• ライブ試合のトラッキング： /espn/scoreboard または /sofascore/live-events を一定間隔でポーリングし、スコアの変化をリアルタイムで報告します。
• 試合前の概要： /sofascore/event-h2h（過去の対戦）と /draftkings/sportsbook/odds または /sofascore/event-odds（市場予想）、さらに両チームの /sofascore/team-events（直近の調子）を利用します。
• 試合後のパフォーマンス概要： インストールされている場合は football-match-performance-analysis を利用し、SofaScore の統計、インシデント、ラインアップに基づいた情報源付きの分析を作成します。
• シーズンのスタッツリーダー： /mlb/league-stats または /espn/rankings で上位選手を確認し、その後 /mlb/player-stats / /espn/athlete で詳細を調べます。
• ロースター／トランザクションの監視： /mlb/team-roster と /mlb/transactions を利用して、今週追加または外された選手を追跡します。
• 優勝オッズの追跡： /draftkings/sportsbook/futures でリーグの優勝／賞のオッズを確認し、/espn/rankings の専門家による見解と比較します。

注意事項と制限

• クレジット／成功時課金： 2xx の場合のみ課金されます。無料枠は月 2,000 クレジットです。 https://crawlora.net でキーを取得してください。
• 公開データのみ — 公開されているスコアボード／統計ページが対象です。オッズは参考情報であり、 賭けサービスではありません。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコードしたり、クエリパラメーターに含めたり、コミットしたりしないでください。
• ESPN と SofaScore は、sport／league パラメーターを通じて多くのスポーツ／リーグに対応しています。リーグがサポートされていると判断する前に、 reference/endpoints.md で指定可能な値を確認してください。
• ライブスコアのエンドポイントは、データソース独自の更新頻度を反映しています。1 秒未満の鮮度を前提にせず、 定期的にポーリングしてください。
• Strava の country／region はプラットフォーム固有のスラッグです。自由記述の名称ではありません。正確なスラッグ形式はツールのスキーマに記載されていないため、/strava/routes が 404 を返す場合は crawlora.net/docs またはプレイグラウンド で有効な値を確認してください。/strava/challenges はパラメーター不要で、 安全に利用を開始できます。

Cricinfo と Sportskeeda の編集コンテンツおよびスポーツデータ

Cricinfo では、公開されているクリケットのスコアカード、実況、プロフィール、記録、記事を提供しています。 利用可能なトーナメントやシリーズを特定するには、探索用エンドポイントを使用してください。これらは編集者／プロバイダーが提供する時点のスナップショットであり、公式リーグの記録ではありません。

Sportskeeda では、ニュース／記事、著者やトピックに関する情報、サポート対象のサッカーやその他のスポーツデータ、コミュニティやメディアのページを提供しています。各ルートで必要となる特定のリーグ、セクション、識別子については、エンドポイントリファレンスを確認してください。サッカーの表示を選択する前に、sportskeeda_football_options を使って選択肢を確認してください。編集コンテンツのデプスチャートやニュース報道は、公式のロスター発表やライブスコアフィードではありません。 ESPN／SofaScore の ID を Sportskeeda で使用しないでください。

scripts/crawlora.sh /sportskeeda/football-options

FotMob で選手／サッカーを分析する場合は fotmob-research を使用してください。Flashscore または LiveScore の試合を検索する場合は、インストールされていれば multi-sport-match-research を使用してください。このバンドル済みヘルパーは、独自のエンドポイントリファレンスに記載されたプロバイダーのみを保持します。