电竞数据查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/esports-oarv。
技能介绍
解决什么问题
做电竞数据相关开发时,经常需要拉取职业赛事结果、战队排名或赛程表,但公开接口大多需要注册 API key,而数据提供方又散落在不同平台:Dota 2 有 OpenDota,英雄联盟电竞数据则集中在 Leaguepedia。这个技能的目标就是把这些免密钥公开数据源封装成统一的命令入口,让脚本或 Agent 不需要处理密钥管理与多源适配。
它如何工作
技能覆盖两个主要数据域,分别走不同的后端:
- Dota 2 比赛、战队、联赛数据全部来自 OpenDota(
api.opendota.com),返回真实 JSON,免费层约 60 req/min。对应命令包括get_pro_matches(近期职业比赛)、get_match(按 id 取详细比赛)、get_pro_teams(按 rating 排序的顶级战队)、get_leagues(可按 tier 过滤的联赛/锦标赛)。 - 英雄联盟电竞数据走 Leaguepedia Cargo(
lol.fandom.com),以结构化行的形式返回。常用命令是get_lol_tournaments获取近期锦标赛;需要自定义查询时用lol_cargo_query,直接指定表和字段,例如Tournaments(Name、DateStart、DateEnd、League、Region、Prizepool)、MatchSchedule(Team1、Team2、Winner、DateTime_UTC、BestOf)、ScoreboardGames、Players、Teams等。由于字段随表变化,建议先跑一条小查询确认 schema。
关键分工原则:比赛/战队/联赛数据只走 OpenDota,LoL 电竞数据只走 Leaguepedia Cargo,不要把两者混在一个接口后面。
适用边界与注意点
- Leaguepedia 限流很激进,而且被限流时返回的是 HTTP 200,错误信息在响应体里(
Leaguepedia API error: ...),不是 4xx。看到这个就要等一会儿再试,技能侧已缓存约 30 分钟来缓解。 - OpenDota 是志愿者维护的 best-effort 基础设施,没有 SLA。偶尔拿到空的比赛或战队列表属于瞬时故障,重试即可。
- 这里没有任何赔率数据。博彩赔率无法通过免密钥方式获取;如果需要隐含概率信号,应改用
kalshi get_esports_odds --game=cs2或polymarket get_esports_events。 - 数据使用受第三方条款约束:OpenDota 是 MIT,Leaguepedia 是 CC-BY-SA,复用 Leaguepedia 数据时必须署名 Leaguepedia。仅限个人使用。
使用场景
- 核对联赛奖金与赛程时,从 Leaguepedia Cargo 查询 `Tournaments` 与 `MatchSchedule` 字段。
- 按 id 拉取一场 Dota 2 职业比赛详情,用于复盘队内选手数据。
- 整理战队实力榜时,调用 `get_pro_teams` 获取按 rating 排序的顶级战队列表。
- 检索近期 LoL 赛事锦标赛时,用 `get_lol_tournaments` 列出比赛名称、时间与地区。
适合人员
- 游戏数据分析师,需要免密钥拉取 Dota 2 与 LoL 赛事数据做统计。
- 电竞内容编辑,要定期核对赛程、奖金池并署名 Leaguepedia 来源。
- Agent 开发者,想把 OpenDota 与 Leaguepedia Cargo 封装进自动化数据流。
- 关注战队排名的电竞爱好者,想快速查询顶级战队 rating 排行。