查询荷兰排球联赛数据（Nevobo API）：积分榜、赛程…

当用户询问荷兰排球（Eredivisie、Topdivisie、Superdivisie 及荷兰排球金字塔）的积分榜、赛程、赛果、俱乐部、赛事或新闻时使用。

适用场景

解决思路

1. 首次使用前检查 CLI 是否可用：运行 `which sports-skills || pip install sports-skills`；若 pip 安装失败（包不存在或 Python 版本错误），改用 `pip install git+https://github.com/machina-sports/sports-skills.git` 从 GitHub 安装。
2. 该包要求 Python 3.10+；若默认 Python 版本过低，先运行 `python3 --version` 检查版本，再尝试 `python3.12 -m pip install sports-skills`；在 macOS 配合 Homebrew 时可用 `/opt/homebrew/bin/python3.12 -m pip install sports-skills`。无需 API key，所有数据来自 Nevobo 公开 API。
3. 优先使用 CLI 以避免 Python 导入路径问题，例如：`sports-skills volleyball get_competitions`、`sports-skills volleyball get_standings --competition_id=nevobo-eredivisie-heren`、`sports-skills volleyball get_results --competition_id=nevobo-eredivisie-dames`、`sports-skills volleyball get_schedule --competition_id=nevobo-topdivisie-heren-a`。
4. 也可使用 Python SDK：`from sports_skills import volleyball`，然后调用 `volleyball.get_standings(competition_id="nevobo-eredivisie-heren")`、`volleyball.get_results(competition_id="nevobo-eredivisie-dames")`。
5. 查询前先查阅 `references/api-reference.md` 了解端点、ID 约定和数据形状。
6. 调用任何数据端点前，确认 `competition_id` 来自 `references/competition-ids.md` 中的有效值，绝不猜测。
7. 对于俱乐部相关命令，先通过 `get_clubs` 获取有效的 Nevobo `club_id`（即 `organisatiecode` 字段），不要猜测俱乐部 ID 或赛事 ID；用 `get_competitions` 或 `get_clubs` 发现它们。
8. `competition_id` 遵循模式 `nevobo-<league>-<gender>[-<pool>]`，已预配置前 3 个层级的 8 个联赛：Eredivisie（第 1 层级，8 队）为 `nevobo-eredivisie-heren`、`nevobo-eredivisie-dames`；Topdivisie（第 2 层级，每组 10 队）为 `nevobo-topdivisie-heren-a`、`nevobo-topdivisie-heren-b`、`nevobo-topdivisie-dames-a`、`nevobo-topdivisie-dames-b`；Superdivisie（第 3 层级，10 队）为 `nevobo-superdivisie-heren`、`nevobo-superdivisie-dames`。
9. 对于更低级别（1e/2e/3e Divisie、地区、青年、沙滩——6400+ poules），使用 `get_poules` 发现它们；完整参考（含队伍数量和荷兰排球金字塔）见 `references/competition-ids.md`。
10. 可用命令：`get_competitions`（列出所有可用赛事和联赛）、`get_standings`（联赛积分榜：排名、球队、场次、积分）、`get_schedule`（即将进行的比赛：球队、场地、日期）、`get_results`（比赛结果：比分、逐局比分）、`get_clubs`（列出排球俱乐部：名称、城市、省份）、`get_club_schedule`（俱乐部所有球队的即将进行的比赛）、`get_club_results`（俱乐部所有球队的比赛结果）、`get_poules`（浏览 Nevobo poules，用于发现低级别联赛）、`get_tournaments`（赛事日历）、`get_news`（协会新闻）；完整参数列表和返回形状见 `references/api-reference.md`。
11. 示例：查询 Eredivisie 积分榜时，分别调用 `get_standings(competition_id="nevobo-eredivisie-heren")` 和 `get_standings(competition_id="nevobo-eredivisie-dames")`，返回排名、队名、场次和积分。
12. 示例：查询近期赛果时，调用 `get_results(competition_id="nevobo-eredivisie-heren")`，返回主客队、比赛比分（如 "3-1"）和逐局比分（如 ["25-21", "25-18", "21-25", "25-20"]）。
13. 示例：查询俱乐部赛程时，先调用 `get_clubs(limit=10)` 找到 LSV 的 organisatiecode（CKL5C67），再调用 `get_club_schedule(club_id="CKL5C67")`，返回该俱乐部所有球队的即将进行的比赛及场地和日期。
14. 示例：查询第二层级积分榜时，分别调用 `get_standings(competition_id="nevobo-topdivisie-heren-a")` 和 `get_standings(competition_id="nevobo-topdivisie-heren-b")`，返回两个各 10 队的组表。
15. 示例：发现低级别联赛时，调用 `get_poules(regio="nationale-competitie", limit=20)`，返回国家级 poules 列表，包括 1e/2e/3e Divisie 及其缩写和描述。
16. 绝不调用不存在的命令：`get_scoreboard`（用 `get_results` 查近期赛果）、`get_rankings`（排球用 `get_standings` 查积分榜）、`get_team_roster`（用 `get_clubs` 查俱乐部信息）、`get_player_info`（此 API 不提供球员级数据）；若命令不在上述命令表中，则不存在。
17. 命令失败时不要向用户暴露原始错误：静默捕获并尝试替代方案；若给的是俱乐部名称而非 ID，先用 `get_clubs` 找到 `organisatiecode`；若 `competition_id` 返回无数据，用 `get_competitions` 验证可用联赛；仅在穷尽替代方案后以简洁消息报告失败。
18. 故障排查：`sports-skills` 命令未找到时，运行 `pip install sports-skills`，若不在 PyPI 则用 `pip install git+https://github.com/machina-sports/sports-skills.git`；积分榜返回空列表时，可能是常规赛阶段已结束或赛季未开始，用 `get_results` 查近期赛果或用 `get_poules` 发现当前活跃的 poule 路径；赛程返回 0 场比赛时，可能是该 poule 的比赛阶段已完成，这在赛季阶段之间属正常，可检查其他联赛（Topdivisie/Superdivisie 可能仍活跃）；俱乐部赛程/赛果报错时，可能是 club_id 不正确，用 `get_clubs` 查找有效俱乐部 ID（`organisatiecode` 字段，如 "CKL5C67"）；连接错误或超时时，Nevobo API 可能暂时不可用，稍等后重试，该 API 公开且无需认证但可能有短暂中断。

适用边界 · 注意事项

• 用户询问其他运动时不要使用——足球用 football-data，NFL 用 nfl-data，NBA 用 nba-data，WNBA 用 wnba-data，NHL 用 nhl-data，MLB 用 mlb-data，高尔夫用 golf-data，板球用 cricket-data，大学橄榄球用 cfb-data，大学篮球用 cbb-data，网球用 tennis-data，F1 用 fastf1。
• 需要博彩赔率时不要使用——改用 polymarket 或 kalshi。
• 需要一般新闻时不要使用——改用 sports-news。