斯诺克

查询实时斯诺克数据——排名、比赛结果、选手资料等。

需要从 api.snooker.org 获取 API 密钥。将环境变量 SNOOKERAPIKEY 设置为你的 API 密钥。请注意，当前 API 速率限制为每分钟 10 次请求。

脚本

bash
{baseDir}/snooker.py <命令> [选项]

命令

bash

当前世界排名（前 20 名）

{baseDir}/snooker.py rankings

特定赛季的排名

{baseDir}/snooker.py rankings --season 2024

选手资料（按姓名搜索）

{baseDir}/snooker.py player OSullivan {baseDir}/snooker.py player Ronnie

按数字 ID 查询选手资料（速度更快——当你已有 ID 时使用）

{baseDir}/snooker.py player-id 16

近期比赛结果（返回 Player1ID、Player2ID、EventID——使用 player-id/event 解析名称）

{baseDir}/snooker.py results {baseDir}/snooker.py results --days 3

按数字 ID 查询赛事详情

{baseDir}/snooker.py event 2205

进行中的实时比赛

{baseDir}/snooker.py live

明天（默认）或特定日期的赛程安排

{baseDir}/snooker.py upcoming {baseDir}/snooker.py upcoming --date 2026-03-15

特定选手的 upcoming 比赛（所有未来比赛，不仅限于明天）

{baseDir}/snooker.py upcoming --player Hawkins {baseDir}/snooker.py upcoming --player Ronnie OSullivan

明天（默认）或特定日期的活跃赛事

{baseDir}/snooker.py tournaments {baseDir}/snooker.py tournaments --date 2026-03-15

明天或特定日期的完整赛程（赛事 + 比赛）

{baseDir}/snooker.py schedule {baseDir}/snooker.py schedule --date 2026-03-15

历史交锋记录（按位置拆分姓名对）

{baseDir}/snooker.py h2h Ronnie OSullivan Mark Selby

备注

• - 所有数据均来自主要职业巡回赛（巡回赛 ID：main）
• 排名显示当前赛季按奖金排名的前 20 名
• 如果姓名存在歧义，player 最多返回 3 个匹配结果
• h2h 按姓氏或全名搜索——如果姓名存在歧义，请尽量具体