Yahoo Sports MCP server for AI agents
Let Claude, ChatGPT or your own agent read Yahoo Sports: 20 typed functions through one MCP server. No Yahoo Sports API key needed.
- Site
- sports.yahoo.com
- Functions
- 20
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Yahoo Sports alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/yahoo_sportsOne MCP server for Yahoo Sports and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
findPlayersFinds players on one team's roster by name.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes teamSlugstringAbbreviation (getOdds' abbr "IND") is resolved via standings; no fuzzy guess.Yes querystringYes Returns
YahooSportsPlayerRow[]interface YahooSportsPlayerRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; playerId: string; name: string; position: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/findPlayersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.findPlayers({ league: "nfl", teamSlug: "detroit", query: "a" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.findPlayers({"league": "nfl", "teamSlug": "detroit", "query": "a"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/findPlayers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl","teamSlug":"detroit","query":"a"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.findPlayers({ league: "nfl", teamSlug: "detroit", query: "a" });getFantasyLeagueReads the CALLER's own fantasy football league.Arguments
Name Type Required leagueIdstringThe league's numeric id off its own URL (football.fantasysports.yahoo.com/f1/<leagueId>).Yes Returns
YahooFantasyLeagueDetailinterface YahooFantasyStandingsRow { teamId: string; teamName: string; rank: number; wins: number; losses: number; ties: number; pointsFor: number; pointsAgainst: number; streak: string | null; waiverPriority: string | null; moves: string | null; } interface YahooFantasyMatchupTeam { teamId: string; teamName: string; record: string | null; score: number; } interface YahooFantasyMatchup { teams: [YahooFantasyMatchupTeam, YahooFantasyMatchupTeam]; } interface YahooFantasyLeagueDetail { leagueId: string; leagueName: string; week: number | null; standings: YahooFantasyStandingsRow[]; matchups: YahooFantasyMatchup[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getFantasyLeagueCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getFantasyLeague({ leagueId: "101" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getFantasyLeague({"leagueId": "101"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getFantasyLeague \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"leagueId":"101"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getFantasyLeague({ leagueId: "101" });getFantasyTeamReads the CALLER's own fantasy team.Arguments
Name Type Required leagueIdstringThe league's numeric id off its own URL (football.fantasysports.yahoo.com/f1/<leagueId>).Yes teamIdstringThe team's numeric id off its own URL (football.fantasysports.yahoo.com/f1/<leagueId>/<teamId>).Yes Returns
YahooFantasyTeamDetailinterface YahooFantasyRosterSlot { slot: string; playerId: string | null; name: string | null; nflPosition: string | null; nflTeam: string | null; } interface YahooFantasyTeamDetail { leagueId: string; teamId: string; teamName: string; week: number | null; roster: YahooFantasyRosterSlot[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getFantasyTeamCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getFantasyTeam({ leagueId: "101", teamId: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getFantasyTeam({"leagueId": "101", "teamId": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getFantasyTeam \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"leagueId":"101","teamId":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getFantasyTeam({ leagueId: "101", teamId: "1" });getGameReads one game in full off its own game page.Arguments
Name Type Required gameUrlstringYes Returns
YahooSportsGameDetailinterface YahooSportsBoxScorePlayerLine { playerId: string; name: string; stats: YahooSportsPlayerStat[]; } interface YahooSportsBoxScoreCategory { category: string; players: YahooSportsBoxScorePlayerLine[]; } interface YahooSportsBoxScore { away: YahooSportsBoxScoreCategory[]; home: YahooSportsBoxScoreCategory[]; } interface YahooSportsGameRecapPlay { description: string; team: string | null; timestamp: string | null; } interface YahooSportsGameRecap { summary: string | null; keyPlays: YahooSportsGameRecapPlay[]; } interface YahooSportsGameDetail { name: string; homeTeam: string; awayTeam: string; homeScore: number | null; awayScore: number | null; status: "scheduled" | "in_progress" | "final"; startDate: string; venue: string | null; boxScore: YahooSportsBoxScore | null; // null before the game starts recap: YahooSportsGameRecap | null; // null before the game starts } interface YahooSportsPlayerStat { name: string; abbreviation: string; value: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getGameCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getGame({ gameUrl: "<gameUrl>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getGame({"gameUrl": "<gameUrl>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getGame \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"gameUrl":"<gameUrl>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getGame({ gameUrl: "<gameUrl>" });getInjuriesReads a league's full injury report the way its own Injuries page does.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes Returns
YahooSportsInjuryRow[]interface YahooSportsInjuryRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; team: string; teamSlug: string | null; playerId: string; name: string; url: string | null; status: string; // the site's own labels, read the values off a result, never guess one from prose; e.g. "Questionable", "Out" statusAbbr: string; description: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getInjuriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getInjuries({ league: "nfl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getInjuries({"league": "nfl"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getInjuries \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getInjuries({ league: "nfl" });getNewsReads a league's News tab, all story headlines, links, sources and publication times from Yahoo Sports' own news page.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes Returns
YahooSportsNewsinterface YahooSportsNewsStory { headline: string; url: string; source: string | null; published: string | null; tags: string[]; } interface YahooSportsNews { league: string; stories: YahooSportsNewsStory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getNews({ league: "nfl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getNews({"league": "nfl"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getNews({ league: "nfl" });getOddsReads a league's current betting lines off the site's own Odds page.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes Returns
YahooSportsOddsGame[]interface YahooSportsOddsTeamLine { team: string; // full display name, e.g. "Indianapolis Colts", a label, not a teamSlug abbr: string; // e.g. "IND", getSchedule/getTeamRoster/findPlayers take this as teamSlug spread: string | null; // e.g. "-3.5", null if the market has not posted one spreadNote: string | null; total: string | null; // WITH its own over/under marker, e.g. "O 48.5", "U 48.5" totalNote: string | null; moneyline: string | null; // American odds, e.g. "-207", "+167" moneylineNote: string | null; } interface YahooSportsOddsGame { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; // Always away-then-home, the same order as getScoreboard's own data, the // page itself labels neither side. teams: [YahooSportsOddsTeamLine, YahooSportsOddsTeamLine]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getOddsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getOdds({ league: "nfl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getOdds({"league": "nfl"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getOdds \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getOdds({ league: "nfl" });getPlayerReads one player's profile and current-season stat line off their own player page.Arguments
Name Type Required playerUrlstringYes Returns
YahooSportsPlayerDetailinterface YahooSportsPlayerStat { name: string; abbreviation: string; value: string; } interface YahooSportsPlayerStatGroup { category: string; stats: YahooSportsPlayerStat[]; } interface YahooSportsPlayerDetail { playerId: string; name: string; position: string; team: string; // display label, e.g. "Detroit Lions" teamSlug: string | null; // e.g. "detroit", getSchedule/getTeamRoster/findPlayers take this as teamSlug college: string | null; displayHeight: string | null; weight: number | null; birthDate: string | null; jerseyNumber: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose currentSeasonStats: YahooSportsPlayerStatGroup[]; recentGames: YahooSportsPlayerRecentGame[]; // last THREE games only, newest first; may reach into last season; [] off-season } interface YahooSportsPlayerRecentGame { season: number | null; week: number | null; date: string | null; seasonPhase: string | null; result: string | null; // e.g. "L 24-28", the player's team first opponent: string | null; opponentAbbr: string | null; home: boolean | null; gameUrl: string | null; // the url getGame takes stats: YahooSportsPlayerStat[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getPlayerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getPlayer({ playerUrl: "<playerUrl>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getPlayer({"playerUrl": "<playerUrl>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getPlayer \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"playerUrl":"<playerUrl>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getPlayer({ playerUrl: "<playerUrl>" });getPlayerNewsReads one player's News tab.Arguments
Name Type Required playerUrlstringThe url getPlayer takes, e.g. "https://sports.yahoo.com/nfl/players/30123/".Yes Returns
YahooSportsPlayerNewsinterface YahooSportsPlayerNewsItem { headline: string; url: string; // the item's page on Yahoo Sports sourceUrl: string | null; // the publisher's own copy, when it differs provider: string | null; // e.g. "Chiefs Wire", "NBC Sports" author: string | null; published: string | null; // ISO timestamp summary: string | null; } interface YahooSportsPlayerNews { playerUrl: string; stories: YahooSportsPlayerNewsItem[]; // the player's story stream, newest first (about ten) videos: YahooSportsPlayerNewsItem[]; // the player's video rail (about thirty), team-level clips mixed in }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getPlayerNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getPlayerNews({ playerUrl: "<playerUrl>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getPlayerNews({"playerUrl": "<playerUrl>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getPlayerNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"playerUrl":"<playerUrl>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getPlayerNews({ playerUrl: "<playerUrl>" });getRankingsReads a college poll, who is ranked, off Yahoo's own Rankings page and the rankings service behind it: college football AP Top 25, Coaches and the…Arguments
Name Type Required league"college-football" | "college-basketball"Default "college-football".No pollstringCollege-basketball: "AP_TOP_25" (default) | "USA_TODAY_ESPN".No datestringYYYY-MM-DD, the poll in force that day; default the latest.No Returns
YahooSportsRankingsinterface YahooSportsRankingRow { rank: number; previousRank: number | null; // null when unranked last week team: string; teamId: string | null; teamUrl: string | null; // the team's page wins: number | null; losses: number | null; points: number | null; // poll points (AP, Coaches); null for the CFP } interface YahooSportsRankings { league: string; poll: string; // e.g. "AP_TOP_25" pollName: string | null; // e.g. "AP Top 25" date: string | null; // the poll's release date, YYYY-MM-DD week: number | null; rankings: YahooSportsRankingRow[]; // rank order, usually 25 }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getRankingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getRankings({ league: "college-football", poll: "AP_TOP_25" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getRankings({"league": "college-football", "poll": "AP_TOP_25"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getRankings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"college-football","poll":"AP_TOP_25"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getRankings({ league: "college-football", poll: "AP_TOP_25" });getRssFeedReads a league's own RSS feed the way finance.yahoo.com/news/rssindex does for markets.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes Returns
YahooSportsRssFeedItem[]interface YahooSportsRssFeedItem { title: string | null; link: string | null; published: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getRssFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getRssFeed({ league: "nfl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getRssFeed({"league": "nfl"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getRssFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getRssFeed({ league: "nfl" });getScheduleReads a team's full schedule for the season the way its own Schedule page does.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes teamSlugstringReturn it, or an exact team name/abbreviation (getOdds' abbr "IND"), resolved via standings.Yes Returns
YahooSportsScheduleRow[]interface YahooSportsScheduleRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; opponent: string; date: string; result: "W" | "L" | "T" | null; score: string | null; isHome: boolean; // This game's own page, the gameUrl getGame takes. Null only if Yahoo's // own payload omitted alias.url for this game, which was not observed in // measurement. gameUrl: string | null; // "FINAL", "PREGAME", … status: string | null; week: number | null; // "PRESEASON", "REGULAR_SEASON", … seasonPhase: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getScheduleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getSchedule({ league: "nfl", teamSlug: "detroit" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getSchedule({"league": "nfl", "teamSlug": "detroit"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getSchedule \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl","teamSlug":"detroit"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getSchedule({ league: "nfl", teamSlug: "detroit" });getScoreboardReads games for one league.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes weeknumberOptional week number (1-17) for football leagues; filters to that week's games.No datestringOptional date for daily leagues; filters to that day's games.No Returns
YahooSportsGameRow[]interface YahooSportsGameRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; name: string; homeTeam: string; awayTeam: string; homeScore: number | null; awayScore: number | null; status: "scheduled" | "in_progress" | "final"; startDate: string; venue: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getScoreboardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getScoreboard({ league: "nfl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getScoreboard({"league": "nfl"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getScoreboard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getScoreboard({ league: "nfl" });getStandingsReads a league's full standings table the way its own Standings page does.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes Returns
YahooSportsStandingsRow[]interface YahooSportsStandingsRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; team: string; // The site's own short team slug off that team's /teams/<slug>/ page, // e.g. "detroit", "ny-yankees", the same slug getSchedule, getTeamRoster // and findPlayers all take as teamSlug. Null if the row's anchor is missing. slug: string | null; wins: number; losses: number; ties: number; winPercentage: number; pointsFor: number; pointsAgainst: number; pointsDifferential: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getStandingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getStandings({ league: "nfl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getStandings({"league": "nfl"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getStandings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getStandings({ league: "nfl" });getStatLeadersReads the season-to-date individual leaderboard for one category off the site's own Stats page.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes categorystring"Scoring", these differ per league and are not a closed set.Yes Returns
YahooSportsStatLeaderRow[]interface YahooSportsStatLeaderRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; category: string; // the site's own category heading, verbatim rank: number; name: string; url: string | null; team: string | null; // an abbreviation ("PIT") or team nickname ("Saints") depending on Yahoo's own CDN asset for that row, null for a team-level row. getSchedule/getTeamRoster/findPlayers take an abbreviation as teamSlug; a nickname is refused (pass listTeams' slug) value: string; // the site's own displayed value, not re-parsed (some categories are decimals) statLabel: string; // the site's own label for what value measures, e.g. "Passing Yards" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getStatLeadersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getStatLeaders({ league: "nfl", category: "Passing" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getStatLeaders({"league": "nfl", "category": "Passing"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getStatLeaders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl","category":"Passing"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getStatLeaders({ league: "nfl", category: "Passing" });getTeamNewsReads one team's own News tab.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes teamSlugstringListTeams()' slug, e.g. "kansas-city", or an exact team name/abbreviation.Yes Returns
YahooSportsTeamNewsinterface YahooSportsPlayerNewsItem { headline: string; url: string; // the item's page on Yahoo Sports sourceUrl: string | null; // the publisher's own copy, when it differs provider: string | null; // e.g. "Chiefs Wire", "NBC Sports" author: string | null; published: string | null; // ISO timestamp summary: string | null; } interface YahooSportsTeamNews { league: string; teamSlug: string; stories: YahooSportsPlayerNewsItem[]; // the team's story stream, newest first (the first page, about five) videos: YahooSportsPlayerNewsItem[]; // the team's video rail (about thirty) }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getTeamNews({ league: "nfl", teamSlug: "kansas-city" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getTeamNews({"league": "nfl", "teamSlug": "kansas-city"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl","teamSlug":"kansas-city"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getTeamNews({ league: "nfl", teamSlug: "kansas-city" });getTeamRosterReads one team's current roster the way its own Roster page does.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes teamSlugstringAbbreviation (getOdds' abbr "IND") is resolved via standings; no fuzzy guess.Yes Returns
YahooSportsRosterRow[]interface YahooSportsRosterRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; playerId: string; name: string; position: string; jerseyNumber: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamRosterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getTeamRoster({ league: "nfl", teamSlug: "detroit" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getTeamRoster({"league": "nfl", "teamSlug": "detroit"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamRoster \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl","teamSlug":"detroit"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getTeamRoster({ league: "nfl", teamSlug: "detroit" });getTeamStatsReads one team's season stats off its own Stats page.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes teamSlugstringListTeams()' slug, e.g. "kansas-city", or an exact team name/abbreviation.Yes Returns
YahooSportsTeamStatsinterface YahooSportsTeamStatValue { key: string; // the site's own stable column id, e.g. "PASSING_YARDS", unique within a category label: string; // the short label as rendered, e.g. "Yds", not unique title: string | null; // the long name, e.g. "Passing Yards" value: string; // the displayed value, verbatim ("1795", "66.4", "34:23", "3-3") } interface YahooSportsTeamStatPlayer { name: string; playerId: string | null; url: string | null; // the url getPlayer takes stats: YahooSportsTeamStatValue[]; } interface YahooSportsTeamStatCategory { category: string; // the site's own heading, verbatim, "Passing", "Rushing", "Averages" players: YahooSportsTeamStatPlayer[]; } interface YahooSportsTeamStats { league: string; teamSlug: string; categories: YahooSportsTeamStatCategory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamStatsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.getTeamStats({ league: "nfl", teamSlug: "kansas-city" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.getTeamStats({"league": "nfl", "teamSlug": "kansas-city"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamStats \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl","teamSlug":"kansas-city"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.getTeamStats({ league: "nfl", teamSlug: "kansas-city" });listTeamsLists every team in a league.Arguments
Name Type Required league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes Returns
YahooSportsTeamRow[]interface YahooSportsTeamRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; team: string; // The site's own short team slug off that team's /teams/<slug>/ page, // e.g. "detroit", "ny-yankees", the same slug getSchedule, getTeamRoster // and findPlayers all take as teamSlug. Null if the row's anchor is missing. slug: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/listTeamsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.listTeams({ league: "nfl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.listTeams({"league": "nfl"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/listTeams \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nfl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.listTeams({ league: "nfl" });searchPlayersSearches for a player by name across every league: NFL, NBA, MLB, NHL, college football, college basketball.Arguments
Name Type Required querystringA player's name or part of it, e.g. "lebron", "geno smith".Yes league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"No Returns
YahooSportsPlayerSearchRow[]interface YahooSportsPlayerSearchRow { league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"; playerId: string; name: string; position: string | null; team: string | null; // display label, e.g. "NY Jets", not a teamSlug active: boolean; // false for a retired/inactive player url: string; // the url getPlayer takes }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_sports/searchPlayersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_sports.searchPlayers({ query: "smith" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_sports.searchPlayers({"query": "smith"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_sports/searchPlayers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"smith"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_sports.searchPlayers({ query: "smith" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/yahoo_sports/<function> - OpenAPI
/v1/sites/yahoo_sports/openapi.json