DunkAPI

DunkAPI MCP 服务

篮球数据 API。 NBA 逐回合数据（包含每次投篮的位置）、技术统计、获胜概率、排名、伤病信息、我们自有的球队 Elo 评分、博彩公司盘口和球员道具投注盘口，以及 WNBA 和 NCAA Division I 男子、女子篮球。REST API 和 MCP 服务。每月免费赠送 500 点数，无需银行卡。

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

You:    "What was each sportsbook's closing spread for every Celtics home game in 2023-24?"
Claude: [calls get_odds]

You:    "Which players took the most shots at the rim in the 2025 playoffs?"
Claude: [calls get_shot_chart]

You:    "How often has Jalen Brunson gone over his points line this season?"
Claude: [calls get_prop_history]

在本地运行（stdio）

大多数客户端可直接连接到 https://mcp.dunkapi.com/mcp。对于启动本地进程的客户端：

git clone https://github.com/noahowsh/dunkapi-mcp.git && cd dunkapi-mcp && npm install
DUNKAPI_API_KEY=your_key node index.js

{ "mcpServers": { "dunkapi": { "command": "node", "args": ["/path/to/dunkapi-mcp/index.js"], "env": { "DUNKAPI_API_KEY": "your_key" } } } }

它会使用你的密钥转发请求到托管服务，因此所有工具和点数费用都相同。

Skills

skills/ 中包含 16 个免费的 Claude skills，可将 Claude 变成 NBA、WNBA 和 NCAA 男子、女子篮球分析师。Skill 是一个 Markdown 文件，包含使用时机、调用的 DunkAPI 工具及其费用、方法（投篮区域和预期得分、节奏和效率、滚动比赛日志、道具投注建模、去水、回测），以及取自真实 API 响应的示例。

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

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

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

也可以使用 skills CLI：npx skills add noahowsh/dunkapi-mcp。

让 Claude 使用 skills/ 文件夹，连接下方的 MCP 服务，然后提出问题。如果不确定该使用哪个 Skill，可以从 dispatch Skill 开始。Skills 也适用于你自己的 CSV 或 JSON 文件，无需密钥。完整列表：skills/README.md。

Python

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

pip install dunkapi
export DUNKAPI_API_KEY=sk_live_...

from dunkapi import Client, to_dataframe

client = Client()

props = client.get_player_props(
    game_id="401810726",
    market="player_points",
    bookmaker="draftkings",
)
df = to_dataframe(props, key="props")
print(df[["player_name", "line", "over_odds", "under_odds"]].head(10))

提供针对密钥无效、点数不足、未找到和速率限制的类型化错误、自动重试，以及用于 pandas 的 to_dataframe。

快速开始

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

Claude Code

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

Claude Desktop、Cursor 和其他客户端

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

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

REST

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

每个工具都通过 POST /v1/{tool} 和 JSON 请求体调用。

示例

examples/ 中提供可运行的 Python（仅使用标准库）和 Node 18+（无依赖项）示例：

• examples/python/quickstart.py 和 examples/node/quickstart.mjs：赛程和头条数据调用。
• examples/python/nba_player_props.py：球员道具投注盘口与赛果对比。

export DUNKAPI_API_KEY=your_key
python3 examples/python/quickstart.py
node examples/node/quickstart.mjs

详情请参阅 examples/README.md。前往 https://dunkapi.com/signup 获取免费密钥（每月 500 点数，无需银行卡）。

工具（18 项）

工具	返回内容
list_teams	某赛季的球队 ID、缩写和颜色
search_players	按姓名查找球员
list_games	按赛季、日期、日期范围或球队查询比赛及比分
get_schedule	即将进行的比赛，以及各体育博彩公司的中位盘口
get_standings	根据每场已结束的比赛统计的排名：总排名、分区、主场、客场、最近 10 场
get_injuries	最新伤病报告：状态、伤情和预计回归时间（NBA、WNBA）
get_ratings	我们的球队 Elo 评分，按排名排列
get_game	单场比赛：双方的技术统计、每位球员的数据、各博彩公司的盘口、胜率
get_player	球员档案、各赛季平均数据和投篮拆分、最近 10 场比赛
get_player_games	球员的完整比赛记录
get_leaders	赛季场均、百分比或总数领先者
get_team_stats	节奏、进攻、防守和净效率，以及四要素
get_odds	各体育博彩公司针对一场比赛（5 家）或某一天（10 家）的独赢盘、让分盘和大小分，以及相对于盘口的赛果
get_plays	逐回合比赛记录，包含投篮位置、区域、预期得分和胜率
get_shot_chart	球员、球队或防守方按区域划分的投篮概况，包含每次投篮的 x/y 坐标
get_line_movement	开赛前各体育博彩公司的盘口快照
get_player_props	各体育博彩公司的球员特殊投注盘口，包含开盘和收盘盘口
get_prop_history	球员特殊投注盘口与赛果的逐场对照记录

联赛：nba（默认）、wnba、ncaam、ncaaw（向任意工具传入 league）。

数据

• NBA 自 2003-04 赛季起的比赛数据，包含逐回合记录和投篮位置（x/y、区域、预期得分、胜率）
• 通过同一套工具提供 WNBA、男子和女子 NCAA 一级篮球数据
• 球队 Elo 评分、根据每场已结束比赛统计的排名、伤病报告（NBA、WNBA）
• 各体育博彩公司的独赢盘、让分盘和大小分：2013-14 至 2023-24 赛季的常规赛 NBA 每场比赛覆盖 4 至 12 家博彩公司（2020-21 赛季起为 10 至 12 家）；另提供自 2020 年 7 月起的开盘和收盘盘口（2020-21 至 2022-23 赛季每场 NBA 比赛的博彩公司中位数为 7 家，此后为 8 家）；自服务上线起提供赛前盘口快照：每天一次，未来两天内的比赛每小时一次
• 各体育博彩公司的球员特殊投注盘口（得分、篮板、助攻、三分球、得分 + 篮板 + 助攻、盖帽、抢断）：NBA 和 WNBA 自 2023 年 5 月起，男子大学篮球自 2023-24 赛季起；包含每条盘口的赛果（get_player_props、get_prop_history）
• 女子大学篮球：自 2024 年 11 月起提供开盘和收盘盘口（博彩公司中位数为 4 家）；不提供球员特殊投注盘口

赛季覆盖范围可从数据库实时读取：https://dunkapi.com/docs

实用页面

• 实时赔率和盘口：https://dunkapi.com/odds
• 今日球员道具投注（各球员在所有博彩公司中的最佳赔率，数据实时更新，始于 2026-27 赛季揭幕战）：https://dunkapi.com/props
• 今日大学篮球球员道具投注（数据实时更新，始于 2026-27 赛季）：https://dunkapi.com/props/college-basketball
• 大学篮球道具投注历史指南：得分、篮板
• 道具投注指南：得分道具投注历史、三分球道具投注历史
• 指南（Python，使用实时 API 运行）：https://dunkapi.com/guides
  • NBA 逐回合数据、按区域划分的投篮图、回测收盘盘口、球队节奏和效率、球员比赛记录和滚动平均值
• 文档和端点参考：https://dunkapi.com/docs
• 按赛季划分的覆盖范围：https://dunkapi.com/docs/atlas
• 数据集：https://dunkapi.com/data (逐回合数据、投篮图、赔率历史、球员道具投注)
• 定价：https://dunkapi.com/pricing
• 比较：BallDontLie、nba_api 和 stats.nba.com、Basketball Reference、Sportradar、SportsDataIO
• 联赛：WNBA、男子大学篮球、女子大学篮球

定价

每月免费获得 500 点数，无需信用卡。套餐：Starter 每月 19 美元（10,000 点数）、Pro 每月 49 美元（30,000 点数）、Scale 每月 149 美元（125,000 点数）。钱包充值金额从 5 美元起，永不过期。https://dunkapi.com/pricing

署名

评分由我们提供。与 NBA、WNBA、NCAA 或任何球队均无关联。

许可证

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

在 Codex 中使用

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

codex plugin marketplace add noahowsh/dunkapi-mcp

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

export DUNKAPI_API_KEY=your_key

Codex 会将其作为 bearer token 发送。

在 Gemini CLI 中使用

export DUNKAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/dunkapi-mcp

此扩展会添加 DunkAPI MCP 服务（https://mcp.dunkapi.com/mcp），并在 x-api-key 请求头中发送密钥。请访问 https://dunkapi.com/signup 免费获取密钥（每月 500 点数）。