mcpField
F
football-match-performance-analysis

football-match-performance-analysis

github.com/crawlora-orgデータ・データベース122 回インストール2 日前に更新
リポジトリ

football-match-performance-analysis について

単一の SofaScore イベントをもとに、簡潔で根拠に沿った試合レポートを作成するスキルです。分析者やコーチ向けに、記録された事実と解釈を分け、初心者にも伝わる説明を支援します。

主な機能

  1. 01試合の識別情報と状態の確認
  2. 02統計、イベント、ラインアップの収集
  3. 03出典ラベル、数値、期間の保持
  4. 04観察事実と解釈の区別
  5. 05初心者向けの根拠要約

活用シーン

  1. 01終了試合の根拠付きレポート作成
  2. 02進行中の試合をスナップショットとして要約
  3. 03コーチや保護者への試合データ説明

インストール

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

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill football-match-performance-analysis

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

同梱ファイルreference/endpoints.mdscripts/crawlora.sh

詳細

サッカーの試合パフォーマンス分析

1 件の SofaScore イベントに基づき、情報源を明示した試合後の概要を作成します。目的は、情報源に記録された内容と、そこから導ける解釈を説明することであり、少数のボックススコア項目から戦術を再構築したり、再戦を予測したりすることではありません。

対象範囲とイベントの特定

依頼に基づいて、大会、チーム、試合日、タイムゾーンを設定します。SofaScore 検索でイベントを特定し、詳細を収集する前に、返されたイベントから両チーム、大会、予定開始時刻、ステータスを確認します。チーム名が一致するだけでは不十分です。リザーブチーム、ユースチーム、女子チーム、シニアチームが同じ名前を共有している場合があります。

終了した試合は試合後レポートとして分析します。試合中または今後の試合については、出力にスナップショットと明記し、試合終了後の表現を使用しないでください。プロバイダーのステータス、試合時間帯、延長戦やPK戦の区別を維持します。

範囲を限定したイベント記録の収集

  1. SofaScore のイベント ID を特定し、確認します。
  2. 同じイベント ID の試合概要と統計を取得します。各統計について、情報源のラベル、値、単位、期間を保持します。欠損しているカテゴリーは 0 ではなく不明として扱います。
  3. 時系列と先発選手の状況を把握するため、試合中の出来事とラインアップを取得します。レスポンスに実際に示されているフィールドを超えて、選手の役割、負傷、戦術上の役割を推測しないでください。
  4. ユーザーが歴史的な背景を求めた場合に限り、直接対決または最近のチームイベントを使用します。イベントのレスポンスで各チーム ID を確認します。チームイベントの方向は next または last です。終了した試合の好調・不調を評価する際に、将来の対戦予定を混在させないでください。
  5. イベントのオッズは、明示的に役立つ場合に限って取得します。取得したオッズは取得時点のスナップショットと明記し、情報源がその時点を示していない限り、試合前オッズとは呼ばないでください。

原則として対象は 1 試合とします。広範な試合群や繰り返しのスナップショットを収集する前に、ユーザーに確認してください。追加の呼び出しを行っても、因果関係の説明がより確かなものになるとは限らず、コストが増える場合があります。

証拠を慎重に解釈する

  • 数値の差を説明してから、その理由を述べます。ボール支配率、シュート数、期待ゴール数、コーナーキック数、評価点だけでは、チームが勝った理由を立証できません。
  • 試合中の出来事やラインアップの詳細は、時系列や背景を示す証拠として扱い、ある出来事が結果を引き起こした証拠とはみなしません。観測された出来事と解釈を分けてください。
  • 定義の異なる期間やカテゴリーを、同じ指標であるかのように比較しないでください。欠損値、分母の不一致、意味が不明確なラベルを説明します。
  • 最近の好調・不調や直接対決の記録は、予測ではなく小規模な記述的サンプルです。オッズは市場のスナップショットであり、試合の質を説明するものではありません。
  • API が集計統計しか公開していない場合、戦術上の主張をでっち上げないでください。証拠の不足を明確に伝えます。

初心者のコーチや保護者向け

読者が試合分析に不慣れな場合も、同じ証拠の範囲を保ちながら、説明をわかりやすくします。

  1. 役立つ観察点を最大 3 つ選びます。それぞれについて、平易な説明のそばに情報源のラベル、値、期間を示します。指標の意味が情報源から明確にわかる場合に限り、その定義を説明します。
  2. SofaScore が記録した内容と、数値が示唆する可能性を分けます。チーム全体の合計値から、若い選手の能力、努力、指導の質について結論を出さないでください。
  3. ゴールや交代の前後に視聴者が気づいたことなど、利用可能な試合中の出来事の時系列に基づく振り返りの問いかけを 1 つ提示します。ユーザーがすでに試合映像を持っている場合は、その録画で確認できる問いとして提示してください。これらのエンドポイントは動画やクリップを提供しません。
  4. 必要であれば、概要を「気づいたこと」「情報源に記録されたこと」「次に確認すること」のように整理します。試合の集計データだけを根拠に、練習メニューや戦術変更を指示するのは避けてください。

成果物

簡潔なレポートを返します。次の内容を含めてください。

  1. 試合の識別情報、競技、日付とタイムゾーン、終了またはライブのステータス、スコア。
  2. 出典ラベルと対象期間を付けた、最も関連性の高いホーム／アウェイの統計をまとめた短い表。
  3. 数値を適切に解釈するうえで重要な、出典付きの出来事の時系列とラインアップの事実。
  4. 複合的な証拠から裏付けられる内容、解釈にとどまる内容、欠落または曖昧な項目。
  5. 依頼された場合に限り、直近の戦績、直接対決、またはオッズの情報を任意で追加します。その際、これらの証拠の種類は分けてください。

例

scripts/crawlora.sh /sofascore/search q="Arsenal Chelsea 2026-10-05"
scripts/crawlora.sh /sofascore/event id=12345678
scripts/crawlora.sh /sofascore/event-statistics id=12345678
scripts/crawlora.sh /sofascore/event-incidents id=12345678
scripts/crawlora.sh /sofascore/event-lineups id=12345678

上記の数値イベント ID は形式上のプレースホルダーです。検索で確認した ID を使用してください。正確なパラメーターについては reference/endpoints.md を参照し、API キーがヘッダーに保持されるよう scripts/crawlora.sh を使用してください。

コメント

Markdown 対応