EndzoneAPI

EndzoneAPI MCP 服务

橄榄球数据 API。 提供自 1999 年以来每场 NFL 比赛的逐档数据（含 EPA 和获胜概率）、球员和球队统计数据、赛程、伤病情况、阵容深度图和收盘赔率。REST API 和 MCP 服务。每月免费提供 500 点额度，无需信用卡。

网站：https://endzoneapi.com · 文档：https://endzoneapi.com/docs · 获取密钥：https://endzoneapi.com/signup

You:    "What was the closing spread for every Chiefs game last season?"
Claude: [calls get_games -> one call, every game with spread, total and moneyline]

You:    "Which offenses had the best EPA per play on third down in 2025?"
Claude: [calls get_plays with third_down filter -> EPA already attached]

技能

16 个免费的 Claude 技能可将 Claude 变成接入这些工具的橄榄球分析师：每档 EPA 和成功率、Next Gen Stats、每周球员统计数据、赔率和去水、道具投注建模、大学橄榄球和 FCS，以及诚实的回测。它们是纯 Markdown 文件夹。

git clone https://github.com/noahowsh/endzoneapi-mcp.git

也可以将它们安装为 Claude Code 插件：

/plugin marketplace add noahowsh/endzoneapi-mcp
/plugin install endzoneapi-skills@endzoneapi

也可以使用技能 CLI：npx skills add noahowsh/endzoneapi-mcp。

让 Claude（Claude Code 或任何可加载技能的客户端）使用 skills/ 文件夹，并连接上方的 MCP 服务，以便技能调用实时数据。dispatch 技能会将请求分派给最合适的两三个技能。完整列表：skills/README.md

You:    "Which offenses were best on third down in 2025, and how many plays is that based on?"
Claude: [loads epa-analysis + endzoneapi-tool, calls get_plays with third_down and a limit that
         holds the split, reports EPA per play, success rate and the play count]

实用页面

• 本周赔率：https://endzoneapi.com/odds
• 本周球员道具投注（各博彩公司中每位球员的最佳赔率）：https://endzoneapi.com/props
• 道具投注指南：接球码数历史数据、任意时间达阵历史数据、传球码数历史数据
• 指南：https://endzoneapi.com/guides
• 文档：https://endzoneapi.com/docs
• 定价：https://endzoneapi.com/pricing
• 数据覆盖范围：https://endzoneapi.com/data
• 大学橄榄球（FBS）：https://endzoneapi.com/college-football
• FCS 橄榄球：https://endzoneapi.com/fcs-football
• 对比：ESPN API 替代方案、nflfastR API、SportsDataIO 替代方案

Python

官方 Python 客户端已发布到 PyPI：endzoneapi。

pip install endzoneapi
export ENDZONEAPI_API_KEY=sk_live_...

from endzoneapi import Client, to_dataframe

client = Client()

print(client.get_player_props(game_id="2025_01_KC_LAC", estimate_only=True))

props = client.get_player_props(
    game_id="2025_01_KC_LAC",
    market="player_pass_yds",
    bookmaker="draftkings",
)
df = to_dataframe(props, key="props")
print(df[["player_name", "line", "over_odds", "under_odds"]])

针对密钥无效、额度用尽、未找到和请求速率限制的类型化错误，自动重试，以及用于 pandas 的 to_dataframe。

快速开始

这是一个通过 Streamable HTTP 提供的托管（远程）MCP 服务。无需安装任何内容。

Claude Code

claude mcp add --transport http endzoneapi "https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop、Cursor 和其他客户端

{
  "mcpServers": {
    "endzoneapi": {
      "url": "https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

也可以通过 x-api-key 标头或 Authorization: Bearer 传入密钥。连接和列出工具无需密钥；调用工具则需要密钥。

REST

curl -X POST https://mcp.endzoneapi.com/v1/list_teams -H "x-api-key: YOUR_API_KEY"

每个工具都使用带有 JSON 请求体的 POST /v1/{tool}。

工具（18 个）

工具	返回内容
list_teams	全部 32 支球队的信息，包括联盟、分区、颜色和徽标
get_standings	按 NFL 决胜规则确定的排名和季后赛种子席位，并说明决定每个排名的步骤
get_schedule	按周或未来 N 天查询即将进行的比赛
search_players	按姓名、球队或位置查找球员
get_injuries	按球队和周查询伤病报告，包括训练和比赛状态
get_depth_chart	按周查询球队的球员深度图
get_games	按赛季、周、球队、日期、类型或状态查询比赛，并提供收盘盘口
get_team_stats	球队总计数据和逐周数据，包括 EPA、成功率和情境拆分
get_player_stats	单名球员的周度和赛季数据：传球、冲球、接球、防守、踢球、梦幻橄榄球
get_player_leaders	任意统计数据的排行榜，可按位置、球队和赛季筛选
get_snap_counts	按比赛或球员查询进攻、防守和特勤组的上场次数及占比
get_advanced_stats	Next Gen Stats 追踪指标和 Pro Football Reference 高级统计数据
get_plays	逐档比赛记录，包括 EPA、获胜概率、情境筛选，以及可选的 FTN 记录数据
get_odds	按比赛查询赔率，可按博彩公司筛选
get_game_detail	完整比赛详情，包括球队统计数据、首发四分卫、赔率、天气和裁判
get_head_to_head	对阵历史，包括胜负记录和分差
get_line_movement	按博彩公司分组的赔率时间序列
get_player_props	按体育博彩平台查询球员特别投注盘口，包括开盘和收盘盘口：传球、冲球和接球码数、达阵、接球次数、任意时间达阵
get_prop_history	查询单名球员在某个市场中随时间变化的特别投注盘口表现，包括命中率
get_alt_lines	按体育博彩平台查询替代让分和大小分，包括每个盘口阶梯上的所有分值及其赔率

数据

• 自 1999 年以来每场比赛的逐档比赛记录，包括 EPA、获胜概率和模型列
• 自 1999 年以来每场比赛的收盘让分、大小分和独赢盘；自 2020 年起提供各博彩公司赔率（最多 8 家，自 2026 年起赛季期间按小时更新）
• 自 2023 年起的球员特别投注盘口，每场比赛前实时采集
• 每周球员和球队统计数据、伤病信息（2009 年起）、球员深度图（2001 年起）、上场次数（2012 年起）、Next Gen Stats、FTN 记录数据（2022 年起）

各赛季的数据覆盖情况从数据库实时读取：https://endzoneapi.com/data/historical-odds、https://endzoneapi.com/data/player-props 和 https://endzoneapi.com/data/play-by-play

使用者

我们的 NFL 预测网站 NoPunt 基于此 API 运行。

• nfl-props-backtest：以 Python 和 R 对比一个赛季的 NFL 球员特别投注盘口与实际结果（校准、超过盘口比例、盘口变动、任意时间达阵赔率）。

定价

每月 500 个免费点数，无需银行卡。套餐：Starter，每月 $19（10,000 个点数）；Pro，每月 $49（30,000 个点数）；Scale，每月 $149（125,000 个点数）。钱包充值金额从 $5 起，账户有效期间余额可保留。https://endzoneapi.com/pricing

归属声明

统计数据、赛程和逐档比赛记录来自 nflverse（CC BY 4.0），并经过修改，与我们自己的模型结合使用。与 NFL 或任何球队均无关联。

许可证

本仓库内容采用 MIT 许可证。数据条款如上。

在 Codex 中使用

将此仓库添加为 Codex 插件市场，然后安装插件：

codex plugin marketplace add noahowsh/endzoneapi-mcp

然后在 Codex 中打开插件目录，并从 endzoneapi 市场安装 endzoneapi-skills。此插件包含 skills/ 中的技能和 EndzoneAPI MCP 服务（https://mcp.endzoneapi.com/mcp）。先设置你的密钥（可在 https://endzoneapi.com/signup 免费获取）：

export ENDZONEAPI_API_KEY=your_key

Codex 会将其作为 bearer 令牌发送。

在 Gemini CLI 中使用

export ENDZONEAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/endzoneapi-mcp

此扩展会添加 EndzoneAPI MCP 服务（https://mcp.endzoneapi.com/mcp），并在 x-api-key 标头中发送密钥。可在 https://endzoneapi.com/signup 免费获取密钥（每月 500 个点数）。