league-sdk
一个为《英雄联盟》Riot API 设计的全类型 TypeScript SDK。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：league-sdk。 它的用途是：一个为《英雄联盟》Riot API 设计的全类型 TypeScript SDK。 完整的 Skill 内容见：https://321skill.com/skills/league-sdk/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我用 league-sdk 查一下玩家‘Hide on bush/KR1’最近的排位赛战绩和常用英雄。”，它会创建一个 LolClient 实例，调用 `getByRiotId` 获取玩家信息，然后获取其排位赛统计和最近的比赛记录，并整理成清晰的报告输出给你。
介绍
league-sdk 是一个专为 Riot Games《英雄联盟》API 设计的、完全类型化的 TypeScript SDK。它解决了开发者直接调用原始 Riot API 时面临的诸多痛点：需要处理多个不同区域的端点、复杂的路由逻辑以及繁琐的手动数据转换工作。
使用 league-sdk，开发者只需通过一个统一的客户端，即可调用玩家、比赛、熟练度、实时游戏、挑战、数据龙等所有服务。它提供了直观的链式调用和高层抽象，例如通过 Riot ID 直接获取玩家及其排位赛数据，极大地简化了开发流程。
这个 Skill 非常适合需要基于《英雄联盟》游戏数据开发应用或进行数据分析的开发者。无论是构建个人数据追踪工具、开发社区网站、还是进行游戏策略分析，league-sdk 都能提供强大的底层支持。
使用前，你需要从 Riot Games 开发者门户获取 API 密钥。请注意，开发密钥有速率限制（20次/秒，100次/2分钟）和有效期（24小时），生产环境建议注册产品以获取永久密钥。
核心特点
与其它简单的 API 封装库不同，league-sdk 提供了完整的类型定义和高层实体抽象（如 Player、Match 对象），支持链式操作（如 `player.getSoloQueueStats()`），并内置了数据转换和格式化功能，将复杂的多步 API 调用简化为直观的方法调用。
注意事项
此 Skill 仅适用于需要与《英雄联盟》官方 API 交互的场景，不适用于其它游戏或通用 API 调用。
常见问题
如何获取 Riot API 密钥？
前往 Riot Games 开发者门户 (developer.riotgames.com) 注册账号并创建应用即可获取。
这个 SDK 支持哪些游戏区域？
支持所有 Riot API 官方定义的区域和平台，如 'kr'、'euw1'、'na1' 等，在创建客户端时指定即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/league-sdk/raw/index.md 读取 league-sdk 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/league-sdk/raw/index.md（查看排版版本）