关于 PuckAPI
PuckAPI 是面向冰球分析者与开发者的数据 API,涵盖 NHL 和 PWHL 的比赛、球员、球队、逐场事件、计算指标及赔率,可通过 REST 和托管 MCP 服务访问。
主要功能
- 01NHL 与 PWHL 比赛及球队数据
- 02球员和守门员统计
- 03逐场事件与射门位置
- 04预期进球、GSAX、Corsi 和 Fenwick
- 05历史赔率与盘口变动
适用场景
- 01查询比赛结果、赛程和排名
- 02比较球员赛季统计
- 03查看射门图和逐场事件
- 04跟踪比赛期间的博彩公司赔率
MCP 相关
托管 MCP 服务提供比赛、球队、球员、赔率、逐场事件和射门图相关工具。MCP 客户端通过 Streamable HTTP 连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://mcp.puckapi.com/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http noahowsh-puckapi https://mcp.puckapi.com/mcpCursor.cursor/mcp.json
{"mcpServers":{"noahowsh-puckapi":{"type":"http","url":"https://mcp.puckapi.com/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"noahowsh-puckapi":{"type":"http","url":"https://mcp.puckapi.com/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"noahowsh-puckapi":{"type":"http","url":"https://mcp.puckapi.com/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"noahowsh-puckapi":{"serverUrl":"https://mcp.puckapi.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://mcp.puckapi.com/mcp需要授权工具
22| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| league | enum | 否 | 联盟。默认为 nhl。可选值:nhl、pwhl、ohl、whl、qmjhl、echl、ahl、ushl。nhl | pwhl | ohl | whl | qmjhl | echl | ahl | ushl |
| season | string | 否 | 赛季 ID,8 位数字(例如,2024-25 赛季使用 20242025)。也接受 2024-25 和 2024-2025。默认为当前赛季。 |
| division | string | 否 | 按分区筛选(例如,Atlantic、Metropolitan、Central、Pacific) |
| conference | enum | 否 | 按联盟筛选Eastern | Western |
详细介绍
You: "What were last night's NHL scores?"
Claude: [calls get_games → returns scores, periods, shots, goals]
You: "Show me the line movement on the Sabres game"
Claude: [calls get_line_movement → opening line, current line, timestamps, book-by-book]
You: "Compare McDavid and MacKinnon this season"
Claude: [calls get_player_stats x2 → side-by-side goals, assists, points, TOI, shooting %]
快速开始
Claude Desktop —— 添加到 claude_desktop_config.json:
{
"mcpServers": {
"puckapi": {
"url": "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
}
}
}
Claude Code —— 一条命令:
claude mcp add --transport http puckapi \
"https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
其他 MCP 客户端 —— 支持 Streamable HTTP 的任意客户端:
| 设置 | 值 |
|---|---|
| URL | https://mcp.puckapi.com/mcp?key=YOUR_API_KEY |
| 传输方式 | Streamable HTTP |
也接受 Authorization: Bearer 或 x-api-key 标头。连接并列出工具无需密钥;调用工具则需要密钥。
在 puckapi.com 获取免费密钥——500 点数,无需信用卡。
可用工具
比赛 —— 4 个工具
| 工具 | 描述 |
|---|---|
get_games | 比赛结果,包括比分、节次、射门和进球 |
get_schedule | 即将举行和已结束比赛的赛程 |
get_game_detail | 指定比赛的完整技术统计表 |
get_head_to_head | 两支球队之间的历史交锋数据 |
球队 —— 3 个工具
| 工具 | 描述 |
|---|---|
get_standings | 当前或历史赛季排名 |
get_team_stats | 球队级统计数据(进球、射门、PP%、PK% 等) |
list_teams | 所有 NHL 球队及其缩写和元数据 |
球员 —— 5 个工具
| 工具 | 描述 |
|---|---|
search_players | 按姓名查找球员 |
get_player_stats | 滑行球员统计数据(进球、助攻、得分、上场时间等) |
get_skater_season_stats | 赛季统计排行榜——进球、助攻、得分、上场时间、射门命中率;可按球队筛选,并可按 5 项指标排序 |
get_goalie_stats | 守门员统计数据(扑救率、场均失球数、获胜场次、零封场次等) |
get_player_game_log | 球员或守门员在某赛季逐场比赛的数据:进球、助攻、射门、罚时、扑救、扑救率 |
赔率 —— 2 个工具
| 工具 | 描述 |
|---|---|
get_odds | 每场比赛按博彩公司列出的开盘和收盘独赢盘、让球盘及总分盘赔率,涵盖自 2019-20 赛季以来的所有比赛 |
get_line_movement | 按博彩公司分组的时序赔率 |
逐次比赛记录 —— 2 个工具
| 工具 | 描述 |
|---|---|
get_plays | 逐次比赛事件,包含球场坐标、场上人数情况和参与球员 |
get_shot_map | 每次射门尝试的数据,包含球场坐标、射门类型、射手和守门员 |
数据覆盖范围
| 类别 | 详情 |
|---|---|
| 比赛 | 覆盖 16 个赛季,超过 23,000 场 |
| 逐个回合数据 | 自 2010-11 赛季以来的每个事件,均包含冰场坐标(超过 680 万个事件) |
| 赔率 | 自 2019-20 赛季起覆盖每场比赛:2020-21 至 2023-24 赛季每场约 12-14 家博彩公司,2025-26 赛季超过 60 家;自 2026 年 10 月起,每小时采集包含 Pinnacle 在内的 8 家博彩公司数据 |
| 赔率变动 | 自 2026 年 9 月起每小时快照 |
| 球员 | 超过 4,800 名外场球员和守门员 |
| 计算数据 | 预期进球、GSAX、Corsi 和 Fenwick |
| PWHL | 比赛、积分榜、逐个回合数据和射门位置;传入 league: "pwhl"(详情) |
| 更新 | 每日更新比赛;每小时采集赔率 |
按赛季查看实时覆盖范围:历史赔率 · 逐个回合数据 · 射门数据
定价
| 方案 | 每月额度 | 价格 |
|---|---|---|
| 免费 | 每月 500 | $0 |
| 入门版 | 10,000 | $19/月 |
| 专业版 | 30,000 | $49/月 |
| 规模版 | 125,000 | $149/月 |
每次调用工具消耗 1 至 25 个额度(各工具费用)。钱包充值金额最低为 $5,且永不过期。
REST API
PuckAPI 还提供标准 REST API:
curl -X POST https://mcp.puckapi.com/v1/get_standings \
-H "x-api-key: YOUR_API_KEY"
完整文档请访问 puckapi.com/docs。
使用者
我们的 NHL 预测网站 PuckCast 基于此 API 运行。
相关链接
| PuckAPI Skills | 28 个免费的 Claude Code 技能,涵盖冰球分析、投注模型和研究 |
| puckapi.com | 注册、控制面板、API 文档 |
| 今晚的 NHL 赔率 | 每家受追踪博彩公司提供的独赢盘、让球盘和总分盘,每小时刷新 |
| 今日 NHL 球员特别投注 | 得分、进球、射门、扑救和随时得分球员:每位球员的共识盘口,以及最佳大盘和小盘赔率 |
| 射正球门特别投注历史 | 用 Python 按场统计球员射门数超过盘口的频率 |
其他运动,使用相同工具和密钥格式
| EndzoneAPI | NFL 和大学橄榄球 |
| DunkAPI | NBA、WNBA 和大学篮球 |
| FastballAPI | MLB 和大学棒球 |
| StrikerAPI | 足球,涵盖 17 项赛事 |
| AcesAPI | ATP 和 WTA 网球 |
| BirdieAPI | PGA Tour 和其他高尔夫巡回赛 |
| FighterAPI | UFC、PFL 和 Bellator |
puckapi.com · API 文档 · 技能
MIT 许可证
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。