SkillHub

knhm-match-center

v1.0.0

Query Dutch field hockey match schedules and results from KNHB Match Center (hockeyweerelt.nl). Use when looking up hockey clubs, teams, upcoming matches, or match results in the Netherlands.

Sourced from ClawHub, Authored by Thomas A. de Ruiter

Installation

Please help me install the skill `knhm-match-center` from SkillHub official store. npx skills add tader/knhm-match-center

KNHB Match Center

Query the Dutch Hockey Federation (KNHB) Match Center API for clubs, teams, and matches.

API Base URL

https://publicaties.hockeyweerelt.nl/mc

Endpoints

List all clubs

curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq '.data[]'

Response includes: id, name, abbreviation, city, district.name, logo, hockey_types[]

Search clubs by name or city

curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq '.data[] | select(.name | test("Westland"; "i"))'
curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq '.data[] | select(.city | test("Delft"; "i"))'

List teams for a club

curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs/{clubId}/teams" | jq '.data[]'

Response includes: id, name, short_name, type (Veld/Zaal), category_group, category_name, next_match_date

Get upcoming matches for a team

curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/upcoming" | jq '.data[]'

Get official (played) matches for a team

curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/official" | jq '.data[]'

Match response includes: - datetime — ISO 8601 format (UTC) - location.city, location.street, location.description - home_team.name, home_team.club_name - away_team.name, away_team.club_name - home_score, away_score — null for upcoming matches - competition, poule, status, field

Common Queries

Find a club and list its teams

# Find club ID
CLUB_ID=$(curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq -r '.data[] | select(.name | test("Westland"; "i")) | .id' | head -1)

# List teams
curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs/${CLUB_ID}/teams" | jq -r '.data[] | "(.id) (.name) ((.type)) - next: (.next_match_date)"'

Get next match for a specific team

curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/upcoming" | jq '.data[0] | {
  date: .datetime,
  home: .home_team.name,
  away: .away_team.name,
  location: .location.city,
  field: .field
}'

Format match schedule nicely

curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/upcoming" | jq -r '.data[] | "(.datetime | split("T")[0]) (.datetime | split("T")[1] | split(".")[0] | .[0:5]) - (.home_team.name) vs (.away_team.name) @ (.location.city)"'

Team Categories

  • Senioren: Adult teams (H1, D1, etc.)
  • Junioren: U18-U21
  • Jongste Jeugd: Youth teams (MO/JO prefixes)
  • MO = Meisjes Onder (Girls Under)
  • JO = Jongens Onder (Boys Under)
  • Example: MO11 = Girls Under 11

Notes

  • Datetime is in UTC — add 1 hour for Amsterdam winter time (CET), 2 hours for summer (CEST)
  • Use date command or proper date library to convert and get correct day of week
  • type: "Veld" = outdoor field hockey, type: "Zaal" = indoor hockey
  • Teams have separate IDs for Veld and Zaal — always query both to get complete schedule
  • Veld season: ~Sep-Jun (outdoor), Zaal season: ~Nov-Mar (indoor)