Official MLB Team, Schedule & Stat Line Scraper: MCP config, n8n workflow and API

{
  "mode": "getPlayers",
  "statGroup": "hitting",
  "statType": "season",
  "rosterType": "active",
  "leagueId": "both",
  "gameType": "R",
  "leaderCategory": "homeRuns",
  "referenceType": "venues",
  "includeStats": false,
  "includeTeamTotals": false,
  "maxItems": 3
}

---
name: official-mlb-team-schedule-and-stat-line-scraper
description: "One record per MLB team, player, stat line, game, standing, leader, box-score line, venue, league, division, or season calendar row, sourced from the official MLB Stats API. Runs the Apify Actor dataspryva/official-mlb-team-schedule-and-stat-line-scraper. Use when the user needs MLB.com data with fields such as recordType, playerName, teamName, gamePk, officialDate, statGroup and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "dataspryva/official-mlb-team-schedule-and-stat-line-scraper"
  store-url: "https://apify.com/dataspryva/official-mlb-team-schedule-and-stat-line-scraper"
---

# Official MLB Team, Schedule & Stat Line Scraper

Use this skill to fetch MLB.com data with the Apify Actor `dataspryva/official-mlb-team-schedule-and-stat-line-scraper` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | string, required | What to fetch. Nine modes cover teams, players/rosters, player stats, game logs, schedules, standings, box scores, leaders, and reference data. |
| `seasons` | array | Season years, e.g. 2024 or 2025. Leave empty for the current season. Stats cover 1876 onward; schedules cover 1901 onward. |
| `teamIds` | array | Filter by MLB team IDs (147 = Yankees), team names (Yankees), abbreviations (NYY), or team URLs (https://www.mlb.com/yankees). Leave empty for all teams. Used by teams, players, player stats, schedule, standings, box score, and leaders modes. |
| `playerIds` | array | MLB player IDs, e.g. 660271 for Shohei Ohtani. Used by players, player stats, and game log modes. Use Search query to find a player ID by name. |
| `gamePks` | array | MLB game IDs (gamePk), e.g. 822974. Used by mode=getBoxscore. Leave empty to derive games from seasons, dates, or teams. |
| `statGroup` | one of `hitting`, `pitching`, `fielding` | Which stat category to return for players, player stats, game logs, box scores, and leaders. |
| `statType` | one of `season`, `career`, `yearByYear`, `byMonth`, `byDayOfWeek`, `homeAndAway`, `byDateRange` | Scope for mode=getPlayerStats. Season, career, and date-range stats work for the whole player pool; season-by-season, month, day-of-week, and home/away splits require playerIds or teamIds. |
| `rosterType` | one of `active`, `40Man`, `fullSeason`, `depthChart`, `coach` | Which roster to return for mode=getPlayers when teamIds is set. |
| `leagueId` | one of `both`, `AL`, `NL` | Filter standings and leaders to the American League, National League, or both. |
| `gameType` | string | Filter games and stats by game type. Regular season is R; other codes include spring training (S), wild card (F), division series (D), league championship (L), World Series (W), and All-Star (A). |
| `leaderCategory` | string | Stat category for mode=getLeaders. Choose a category that belongs to the selected stat group, e.g. homeRuns, battingAverage, or runsBattedIn for hitting; earnedRunAverage, strikeouts, or saves for pitching; fieldingPercentage or errors for fielding. |
| `referenceType` | one of `venues`, `leagues`, `divisions`, `seasons` | Which reference dataset to return for mode=getReference. |
| `includeStats` | boolean | For mode=getPlayers, attach each player's season stats for the selected stat group. |
| `includeTeamTotals` | boolean | For mode=getBoxscore, add one team-total record per side per game, including the inning-by-inning line score. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "getPlayers",
  "statGroup": "hitting",
  "statType": "season",
  "rosterType": "active",
  "leagueId": "both",
  "gameType": "R",
  "leaderCategory": "homeRuns",
  "referenceType": "venues",
  "includeStats": false,
  "includeTeamTotals": false,
  "maxItems": 3
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/dataspryva~official-mlb-team-schedule-and-stat-line-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/dataspryva~official-mlb-team-schedule-and-stat-line-scraper/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `recordType`, `playerName`, `teamName`, `gamePk`, `officialDate`, `statGroup`, `leaderCategory`, `rank`, `value`, `homeRuns`, `battingAverage`, `era`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.