荷兰曲棍球赛程查询

技能简介

本技能连接荷兰曲棍球联合会（KNHB）Match Center API，可查询荷兰境内曲棍球俱乐部的球队信息、 upcoming 赛程安排及已完成的比赛结果。数据来源为 hockeyweerelt.nl 公开接口。

业务背景

为曲棍球俱乐部管理人员、教练及球迷提供一站式赛事信息入口，无需切换多个平台即可掌握球队动态。支持快速定位目标俱乐部与球队，统筹训练计划与观赛安排，提升信息获取效率。

落地案例：某俱乐部行政人员需为本周末的客场赛事安排大巴，通过输入俱乐部名称检索到旗下所有Veld和Zaal球队，分别获取两队 upcoming 赛程，确认周六下午户外队有客场比赛后，立即协调交通与住宿事宜。

能做什么

• 检索全部注册俱乐部及其所在城市、区域信息
• 按名称或城市搜索特定俱乐部
• 列出某俱乐部的所有球队（含户外Veld/室内Zaal）
• 获取指定球队的 upcoming 比赛日程
• 查询球队已完成的官方比赛结果与比分

使用说明

安装要求：无需额外安装，直接调用 API 端点即可。建议配合 curl 与 jq 使用。

基础调用步骤：

1. 查询俱乐部列表：
   curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq '.data[]'
2. 获取某俱乐部球队：
   curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs/{clubId}/teams" | jq '.data[]'
3. 查询球队 upcoming 比赛：
   curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/upcoming" | jq '.data[]'
4. 查询已完成的官方比赛：
   curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/official" | jq '.data[]'

时间处理注意：返回的 datetime 为 UTC 格式，需加 1 小时（冬季 CET）或 2 小时（夏季 CEST）转换为阿姆斯特丹本地时间。

输入与输出

见下方输入与输出表格。

风险提示

• API 返回时间为 UTC，未做时区转换，直接使用会导致时间显示错误
• Veld（户外）与 Zaal（室内）球队拥有独立 ID，需分别查询才能获取完整赛程
• upcoming 比赛的 home_score/away_score 字段为 null，不可用于比分统计
• 依赖外部公开接口，存在服务变更或限流风险

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tader/knhb-hockey/SKILL.md
来源类型：GitHub 开源仓库