Football xG: Understat Matches, Shots & Tables

io.github.serenido由 GitHub 帳號 serenido 發布v1.0.0更新於 Oct 25, 2026

Understat football xG data: xG tables, matches, shots, players and lineups for top 5 leagues + RFPL.

發布方自己的服務:Shots

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

託管於 Apify 的遠端 MCP 伺服器,提供 Understat 預期進球(xG)資料:六大聯賽的積分表、比賽、射門、球員與陣容。

可以做什麼
  • 取得 xG 聯賽積分表,含 xPts、xG、xGA、npxG、PPDA,可選近期狀態表
  • 查詢賽程與賽果,含主客隊 xG 及勝平負機率
  • 讀取球隊逐場紀錄與球員賽季數據(每 90 分鐘指標)
  • 抓取每次射門的 xG、位置、情境與射門方式,以及陣容和球員逐場紀錄
  • 依模式(table、matches、teamMatches、players、shots、lineups、playerMatches)及聯賽、賽季篩選
適用情境
適合足球數據分析、運彩研究、依 xG 與 xA 挑選夢幻足球球員,以及需要 Understat 數據的賽事報導與資料新聞,且不想自行撰寫爬蟲的情況。
執行需求
遠端 MCP 端點 mcp.apify.com,需在網址中指定此工具;首次使用時透過 OAuth 連結 Apify 帳號。在 Apify 雲端執行,不需本機執行環境或代理設定。依列數計費。
安裝前請注意
依列付費,每 1,000 列 3 美元,從 Apify 帳號額度扣除(免費方案每月含 5 美元)。OAuth 連結會授權伺服器存取你的 Apify 帳號。資料來自 Understat,經 Apify 雲端傳輸。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Football xG: Understat Matches, Shots & Tables,將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.serenido%2Ffootball-xg/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "football-xg-understat-matches-shots-tabl": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=serenido/football-xg-scraper"
    }
  }
}

README

Football xG Scraper API

Get Understat expected goals (xG) data as clean rows: xG league tables, fixtures and results with xG, team match logs (xG, xGA, PPDA), player stats per 90, every shot with xG, lineups. Premier League, La Liga, Bundesliga, Serie A, Ligue 1, RFPL, 2014 to now.

Runs in the cloud on Apify. No servers, no proxy setup, no code to maintain. Open it on Apify

Price: $3 per 1,000 rows. No monthly fee. Apify's free plan gives $5 of usage every month, no credit card needed. Current price.

What you get

  • xG league table: points vs expected points (xPts), xG, xGA, npxG, PPDA, deep passes; optional form table of the last N matches
  • Fixtures and results with home/away xG and Understat's win/draw/loss probabilities
  • Team match logs: xG, xGA, PPDA and deep passes per team per match
  • Player season stats with per-90 numbers (xG90, xA90, xGChain90)
  • Every shot with xG, pitch position, situation and shot type; lineups and player match logs

Quick start: Python

bash
pip install -U apify-client
python
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)

Quick start: JavaScript (Node.js)

bash
npm install apify-client
javascript
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);

Quick start: one HTTP call

Runs the tool and returns the rows in one request. Good for runs under 5 minutes; for bigger runs use the Python or JavaScript example.

bash
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"]}'

Get your token in Apify Console > Settings > API & Integrations.

Use it from AI apps (MCP)

Any app that supports remote MCP servers (Claude, ChatGPT, Cursor, VS Code and others) can run this tool for you. Add this server URL: https://mcp.apify.com?tools=serenido/football-xg-scraper. Your Apify account connects on first use. Example config for Cursor:

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

Input example

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

Other modes: matches, teamMatches, players, shots, lineups, playerMatches. All options are listed on the input page.

Output example (one row)

json
{  "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"}

Download as JSON, CSV or Excel, or connect to Make, Zapier or n8n.

Use cases

  • Football models and betting research
  • Fantasy football (FPL) player picks by xG and xA
  • Match reports and data journalism

More tools by Serenido

Support

Found a bug or need a field? Open an issue here or on the Issues tab on Apify.

Use it only for public data and follow the website's terms and the laws that apply to you. This project is not affiliated with the websites it reads.

來源:README.md,提交 2d35e2b

工具

0
該伺服器需要登入,因此 SourceWeft 無法在沒有帳號的情況下讀取其工具,也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v1.0.0最新Oct 25, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Shots 整合