mcpField
F
Football xG: Understat Matches, Shots & Tables

Football xG: Understat Matches, Shots & Tables

リモート
apify.comゲーム・エンタメ01 日前に更新
リポジトリ公式サイト

Football xG: Understat Matches, Shots & Tables について

Apify上で動作するUnderstatのサッカーデータ収集ツールで、分析、ファンタジーフットボールの調査、スポーツ報道に利用できます。対象リーグとシーズンのxG順位表、試合・チームデータ、選手統計、シュート、ラインナップを取得します。

主な機能

  1. 01xGリーグ順位表の取得
  2. 02日程、結果、確率の取得
  3. 03チームの試合ログの収集
  4. 04選手の90分あたり統計の取得
  5. 05シュートデータとラインナップの取得

活用シーン

  1. 01サッカーモデルの開発と賭けの調査
  2. 02xGとxAによるFPL選手候補の評価
  3. 03試合レポートとデータジャーナリズムの作成

MCP 対応

ApifyのリモートMCPサーバー経由でスクレーパーを公開し、MCPクライアントはApifyアカウントを接続して実行できます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.apify.com/?tools=serenido/football-xg-scraper
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

Football xG スクレイパー API

Understat の期待ゴール数(xG)データを、整然とした行形式で取得できます。xG リーグテーブル、xG 付きの試合日程と結果、チームの試合ログ(xG、xGA、PPDA)、選手の90分あたりのスタッツ、すべてのシュートの xG、ラインナップに対応しています。プレミアリーグ、ラ・リーガ、ブンデスリーガ、セリエA、リーグ・アン、RFPL の2014年から現在までのデータを取得できます。

Apify のクラウド上で実行できます。サーバーもプロキシの設定も、保守するコードも必要ありません。Apify で開く

**料金:**1,000行あたり3ドルです。月額料金はありません。Apify の無料プランでは、クレジットカード不要で毎月5ドル分を利用できます。現在の料金。

取得できるデータ

  • xG リーグテーブル:勝ち点と期待勝ち点(xPts)、xG、xGA、npxG、PPDA、ディープパス。オプションで直近 N 試合のフォームテーブルにも対応
  • ホーム/アウェイの xG と Understat の勝ち/引き分け/負けの確率を含む試合日程と結果
  • チームの試合ログ:各チームの各試合における xG、xGA、PPDA、ディープパス
  • 90分あたりの数値(xG90、xA90、xGChain90)を含む選手のシーズンスタッツ
  • xG、ピッチ上の位置、状況、シュートタイプを含むすべてのシュート、ラインナップ、選手の試合ログ

クイックスタート:Python

pip install -U apify-client
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("serenido/football-xg-scraper").call(run_input={
    "mode": "table",
    "leagues": [
        "EPL",
        "La_liga"
    ],
    "seasons": [
        "current"
    ]
})

for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

クイックスタート:JavaScript(Node.js)

npm install apify-client
import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor("serenido/football-xg-scraper").call({
    "mode": "table",
    "leagues": [
        "EPL",
        "La_liga"
    ],
    "seasons": [
        "current"
    ]
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

クイックスタート:HTTP リクエスト1回

ツールを実行し、1回のリクエストで行データを返します。5分未満の実行に適しています。より大規模な実行には Python または JavaScript の例を使用してください。

curl -X POST "https://api.apify.com/v2/acts/serenido~football-xg-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "table", "leagues": ["EPL", "La_liga"], "seasons": ["current"]}'

トークンは Apify Console > Settings > API & Integrations で取得できます。

AI アプリから使用する(MCP)

リモート MCP サーバーに対応するアプリ(Claude、ChatGPT、Cursor、VS Code など)から、このツールを実行できます。次のサーバー URL を追加してください:https://mcp.apify.com?tools=serenido/football-xg-scraper。初回の使用時に Apify アカウントが接続されます。Cursor の設定例:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=serenido/football-xg-scraper"
    }
  }
}

入力例

{
  "mode": "table",
  "leagues": [
    "EPL",
    "La_liga"
  ],
  "seasons": [
    "current"
  ]
}

その他のモード:matches、teamMatches、players、shots、lineups、playerMatches。すべてのオプションは入力ページに記載されています。

出力例(1行)

{
  "type": "shot",
  "league": "Premier League (England)",
  "season": "2026/27",
  "matchId": "31239",
  "date": "2026-10-12 19:00:00",
  "homeTeam": "Coventry",
  "awayTeam": "Newcastle United",
  "minute": 5,
  "team": "Coventry",
  "player": "Jack Rudoni",
  "result": "Goal",
  "isGoal": true,
  "xG": 0.7612,
  "x": 0.885,
  "y": 0.5,
  "situation": "Penalty",
  "shotType": "LeftFoot"
}

JSON、CSV、Excel 形式でダウンロードするか、Make、Zapier、n8n に接続できます。

使用例

  • サッカーモデルや賭けの調査
  • xG と xA に基づくファンタジーサッカー(FPL)の選手選び
  • 試合レポートやデータジャーナリズム

Serenido のその他のツール

サポート

バグを見つけた場合やフィールドが必要な場合は、こちらまたは Apify の Issues タブで Issue を作成してください。

公開データにのみ使用し、ウェブサイトの利用規約と適用される法律を遵守してください。このプロジェクトは、データを取得するウェブサイトとは提携していません。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。