npm - @sport365/sport-mcp - Versions diffs - 0.1.0 - Mend

@sport365/sport-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md +192 -0
package/basketball-api.md +918 -0
package/bin/sport-mcp.js +39 -0
package/football-api.md +1166 -0
package/native/sport-mcp-server-darwin-arm64 +0 -0
package/native/sport-mcp-server-darwin-x64 +0 -0
package/native/sport-mcp-server-linux-x64 +0 -0
package/native/sport-mcp-server-win32-x64.exe +0 -0
package/package.json +45 -0

package/basketball-api.md ADDED Viewed

@@ -0,0 +1,918 @@
+# 篮球 Skill API 接口文档
+## 1. 基本说明
+- 服务前缀：`/skill-api`
+- 篮球基础数据接口前缀：`/skill-api/bk/data/{domain}/v1`
+- 篮球素材接口前缀：`/skill-api/bk/{domain}/v1`
+- 请求方式：`GET`
+- 请求头：`X-Agent-Key: skill_abc123`
+- 返回结构：`Result<T>`
+常见返回码：
+| code | 含义 |
+| --- | --- |
+| `200` | 成功 |
+| `603` | 缺少必要参数 |
+| `604` | `domain` 不支持 |
+| `605` | `materialIndex` 不支持 |
+| `606` | 数据为空 |
+| `500` | 内部服务错误 |
+## 2. 基础数据接口
+### 2.1 联赛
+#### 2.1.1 根据联赛名称模糊查询联赛列表
+```text
+GET /skill-api/bk/data/league-query/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `leagueName` | `String` | 是 | 联赛名称，支持模糊检索 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `id` | `Long` | 联赛 ID |
+| `nameCnShort` | `String` | 联赛中文简称 |
+补充说明：
+- 最多返回 20 条
+- 当前代码对空结果返回 `200 + []`
+#### 2.1.2 根据联赛 ID 查询联赛详情
+```text
+GET /skill-api/bk/data/league-info/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `leagueId` | `Long` | 是 | 联赛 ID |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `id` | `Long` | 联赛 ID |
+| `nameEn` | `String` | 英文名 |
+| `nameCn` | `String` | 中文名 |
+| `nameCnShort` | `String` | 中文简称 |
+| `currMatchSeason` | `String` | 当前赛季 |
+| `currRound` | `String` | 当前轮次 |
+| `country` | `String` | 国家/地区 |
+| `leagueType` | `String` | 联赛类型 |
+#### 2.1.3 根据联赛 ID 查询赛季与阶段列表
+```text
+GET /skill-api/bk/data/league-stage/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `leagueId` | `Long` | 是 | 联赛 ID |
+| `year` | `String` | 否 | 年份筛选，格式 `yyyy` |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+| `seasonList[].seasonId` | `Long` | 赛季 ID |
+| `seasonList[].seasonName` | `String` | 赛季名称 |
+| `seasonList[].seasonStartTime` | `String` | 赛季开始日期 |
+| `seasonList[].seasonEndTime` | `String` | 赛季结束日期 |
+| `seasonList[].stageList[].stageId` | `Long` | 阶段 ID |
+| `seasonList[].stageList[].stageName` | `String` | 阶段名称 |
+补充说明：
+- `year` 不传时，默认只返回最近 3 个赛季
+### 2.2 比赛
+#### 2.2.1 根据联赛 ID 查询赛程
+```text
+GET /skill-api/bk/data/league-match/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `leagueId` | `Long` | 是 | 联赛 ID |
+| `startDate` | `String` | 否 | 开始日期，格式 `yyyy-MM-dd` |
+| `endDate` | `String` | 否 | 结束日期，格式 `yyyy-MM-dd` |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `matchId` | `Long` | 比赛 ID |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+| `leagueSeasonName` | `String` | 赛季名称 |
+| `stageId` | `Long` | 阶段 ID |
+| `stageName` | `String` | 阶段名称 |
+| `matchTime` | `String` | 比赛时间 |
+| `homeTeamName` | `String` | 主队名称 |
+| `homeTeamId` | `Long` | 主队 ID |
+| `awayTeamName` | `String` | 客队名称 |
+| `awayTeamId` | `Long` | 客队 ID |
+| `homeTeamLogo` | `String` | 主队 logo |
+| `awayTeamLogo` | `String` | 客队 logo |
+| `matchStatus` | `String` | 比赛状态 |
+| `homeScore` | `String` | 主队全场比分 |
+| `awayScore` | `String` | 客队全场比分 |
+| `round` | `String` | 轮次 |
+| `remainTime` | `String` | 当前节剩余时间 |
+补充说明：
+- `startDate` 不传时默认今天 00:00:00
+- `endDate` 不传时默认 `startDate + 7` 天
+- 最大查询跨度为 30 天，单次最多返回 100 场
+- 无数据时返回 `606`
+- 该接口走列表转换逻辑，返回字段不包含分节比分与加时比分
+#### 2.2.2 查询热门赛程
+```text
+GET /skill-api/bk/data/hot-match/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `startDate` | `String` | 否 | 开始日期，格式 `yyyy-MM-dd` |
+| `endDate` | `String` | 否 | 结束日期，格式 `yyyy-MM-dd` |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `matchId` | `Long` | 比赛 ID |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+| `leagueSeasonName` | `String` | 赛季名称 |
+| `stageId` | `Long` | 阶段 ID |
+| `stageName` | `String` | 阶段名称 |
+| `matchTime` | `String` | 比赛时间 |
+| `homeTeamName` | `String` | 主队名称 |
+| `homeTeamId` | `Long` | 主队 ID |
+| `awayTeamName` | `String` | 客队名称 |
+| `awayTeamId` | `Long` | 客队 ID |
+| `homeTeamLogo` | `String` | 主队 logo |
+| `awayTeamLogo` | `String` | 客队 logo |
+| `matchStatus` | `String` | 比赛状态 |
+| `homeScore` | `String` | 主队全场比分 |
+| `awayScore` | `String` | 客队全场比分 |
+| `round` | `String` | 轮次 |
+| `remainTime` | `String` | 当前节剩余时间 |
+补充说明：
+- 两个时间都不传时，按服务端当前时间取 1 天
+- 服务端当前时间早于 `12:00` 时，会先回退 1 天
+- 仅当 `startDate` 和 `endDate` 同时传入时，按指定区间查询
+- 最大查询跨度为 3 天
+- 无数据时返回 `606`
+- 该接口走列表转换逻辑，返回字段不包含分节比分与加时比分
+#### 2.2.3 根据主客队 ID 查询交锋比赛列表
+```text
+GET /skill-api/bk/data/h2h-matches/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `homeTeamId` | `Long` | 是 | 主队 ID，必须大于 `0` |
+| `awayTeamId` | `Long` | 是 | 客队 ID，必须大于 `0` |
+| `startDate` | `String` | 否 | 开始日期，格式 `yyyy-MM-dd` |
+| `endDate` | `String` | 否 | 结束日期，格式 `yyyy-MM-dd` |
+规则说明：
+- `startDate` 和 `endDate` 都不传时，默认查询今天前后 7 天
+- 仅传 `startDate` 时，结束时间为 `startDate + 90 天`
+- 同时传 `startDate` 与 `endDate` 时，最大跨度不超过 90 天，超出会被截断
+- 日期解析失败时，按默认前后 7 天处理
+- 单次最多返回 50 场
+- 无数据时返回 `606`
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `matchId` | `Long` | 比赛 ID |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+| `leagueSeasonName` | `String` | 赛季名称 |
+| `stageId` | `Long` | 阶段 ID |
+| `stageName` | `String` | 阶段名称 |
+| `matchTime` | `String` | 比赛时间 |
+| `homeTeamName` | `String` | 主队名称 |
+| `homeTeamId` | `Long` | 主队 ID |
+| `awayTeamName` | `String` | 客队名称 |
+| `awayTeamId` | `Long` | 客队 ID |
+| `homeTeamLogo` | `String` | 主队 logo |
+| `awayTeamLogo` | `String` | 客队 logo |
+| `matchStatus` | `String` | 比赛状态 |
+| `homeScore` | `String` | 主队全场比分 |
+| `awayScore` | `String` | 客队全场比分 |
+| `round` | `String` | 轮次 |
+| `remainTime` | `String` | 当前节剩余时间 |
+#### 2.2.4 根据比赛 ID 查询比赛详情
+```text
+GET /skill-api/bk/data/match-info/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `matchId` | `Long` | 是 | 比赛 ID，必须大于 `0` |
+补充说明：
+- 代码会补齐联赛、球队、阶段、附加信息与赛果信息后再转换返回
+- 查无数据时返回 `606`
+- 该接口走详情转换逻辑，返回分节比分与加时比分字段
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `matchId` | `Long` | 比赛 ID |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+| `leagueSeasonId` | `Long` | 赛季 ID |
+| `leagueSeasonName` | `String` | 赛季名称 |
+| `stageId` | `Long` | 阶段 ID |
+| `stageName` | `String` | 阶段名称 |
+| `matchTime` | `String` | 比赛时间 |
+| `homeTeamName` | `String` | 主队名称 |
+| `homeTeamId` | `Long` | 主队 ID |
+| `awayTeamName` | `String` | 客队名称 |
+| `awayTeamId` | `Long` | 客队 ID |
+| `homeTeamLogo` | `String` | 主队 logo |
+| `awayTeamLogo` | `String` | 客队 logo |
+| `matchStatus` | `String` | 比赛状态 |
+| `homeHalfScore` | `String` | 主队半场比分 |
+| `awayHalfScore` | `String` | 客队半场比分 |
+| `homeScore` | `String` | 主队全场比分 |
+| `awayScore` | `String` | 客队全场比分 |
+| `homeQ1Score` | `String` | 主队第一节比分 |
+| `awayQ1Score` | `String` | 客队第一节比分 |
+| `homeQ2Score` | `String` | 主队第二节比分 |
+| `awayQ2Score` | `String` | 客队第二节比分 |
+| `homeQ3Score` | `String` | 主队第三节比分 |
+| `awayQ3Score` | `String` | 客队第三节比分 |
+| `homeQ4Score` | `String` | 主队第四节比分 |
+| `awayQ4Score` | `String` | 客队第四节比分 |
+| `homeOt1Score` | `String` | 主队加时 1 比分 |
+| `awayOt1Score` | `String` | 客队加时 1 比分 |
+| `homeOt2Score` | `String` | 主队加时 2 比分 |
+| `awayOt2Score` | `String` | 客队加时 2 比分 |
+| `homeOt3Score` | `String` | 主队加时 3 比分 |
+| `awayOt3Score` | `String` | 客队加时 3 比分 |
+| `round` | `String` | 轮次 |
+| `remainTime` | `String` | 当前节剩余时间 |
+#### 2.2.5 查询比赛可用素材列表
+```text
+GET /skill-api/bk/data/match-material/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `matchId` | `Long` | 是 | 比赛 ID |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `index` | `Integer` | 素材索引 |
+| `description` | `String` | 素材名称 |
+| `outDescription` | `String` | 对外描述，当前返回 `null` |
+#### 2.2.6 根据时间查询情报局赛事列表
+```text
+GET /skill-api/bk/data/intelligence-match/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `startDate` | `String` | 否 | 开始日期，格式 `yyyy-MM-dd` |
+| `endDate` | `String` | 否 | 结束日期，格式 `yyyy-MM-dd` |
+补充说明：
+- `startDate` 和 `endDate` 都不传时，默认查询最近 24 小时内的情报局情报
+- 按情报发布时间过滤，同一场比赛多条情报去重后返回比赛列表
+- 无数据时返回 `606`
+- 该接口走列表转换逻辑，返回字段不包含分节比分与加时比分
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `matchId` | `Long` | 比赛 ID |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+| `leagueSeasonName` | `String` | 赛季名称 |
+| `stageId` | `Long` | 阶段 ID |
+| `stageName` | `String` | 阶段名称 |
+| `homeTeamId` | `Long` | 主队 ID |
+| `awayTeamId` | `Long` | 客队 ID |
+| `homeTeamName` | `String` | 主队名称 |
+| `awayTeamName` | `String` | 客队名称 |
+| `homeTeamLogo` | `String` | 主队 logo |
+| `awayTeamLogo` | `String` | 客队 logo |
+| `matchTime` | `String` | 比赛时间 |
+| `matchStatus` | `String` | 比赛状态 |
+| `homeScore` | `String` | 主队全场比分 |
+| `awayScore` | `String` | 客队全场比分 |
+| `round` | `String` | 轮次 |
+| `remainTime` | `String` | 当前节剩余时间 |
+### 2.3 球队
+#### 2.3.1 根据球队名称模糊查询球队列表
+```text
+GET /skill-api/bk/data/team-query/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `teamName` | `String` | 是 | 球队名称，支持模糊检索 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `teamId` | `Long` | 球队 ID |
+| `nameCnShort` | `String` | 球队中文简称 |
+#### 2.3.2 根据球队名称查询比赛列表
+```text
+GET /skill-api/bk/data/team-match-schedule/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `teamName` | `String` | 是 | 球队名称关键字 |
+补充说明：
+- 先按 `teamName` 模糊匹配球队，再按球队查比赛
+- 每个命中的球队最多返回 2 场比赛：最近的完场比赛 + 未来最近的开赛比赛
+- 只有同时拿到上述两场比赛的球队才会进入最终结果
+- 无匹配数据时返回 `606`
+- 该接口走详情转换逻辑，返回分节比分与加时比分字段
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `matchId` | `Long` | 比赛 ID |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+| `leagueSeasonId` | `Long` | 赛季 ID |
+| `leagueSeasonName` | `String` | 赛季名称 |
+| `stageId` | `Long` | 阶段 ID |
+| `stageName` | `String` | 阶段名称 |
+| `matchTime` | `String` | 比赛时间 |
+| `homeTeamName` | `String` | 主队名称 |
+| `homeTeamId` | `Long` | 主队 ID |
+| `awayTeamName` | `String` | 客队名称 |
+| `awayTeamId` | `Long` | 客队 ID |
+| `homeTeamLogo` | `String` | 主队 logo |
+| `awayTeamLogo` | `String` | 客队 logo |
+| `matchStatus` | `String` | 比赛状态 |
+| `homeHalfScore` | `String` | 主队半场比分 |
+| `awayHalfScore` | `String` | 客队半场比分 |
+| `homeScore` | `String` | 主队全场比分 |
+| `awayScore` | `String` | 客队全场比分 |
+| `homeQ1Score` | `String` | 主队第一节比分 |
+| `awayQ1Score` | `String` | 客队第一节比分 |
+| `homeQ2Score` | `String` | 主队第二节比分 |
+| `awayQ2Score` | `String` | 客队第二节比分 |
+| `homeQ3Score` | `String` | 主队第三节比分 |
+| `awayQ3Score` | `String` | 客队第三节比分 |
+| `homeQ4Score` | `String` | 主队第四节比分 |
+| `awayQ4Score` | `String` | 客队第四节比分 |
+| `homeOt1Score` | `String` | 主队加时 1 比分 |
+| `awayOt1Score` | `String` | 客队加时 1 比分 |
+| `homeOt2Score` | `String` | 主队加时 2 比分 |
+| `awayOt2Score` | `String` | 客队加时 2 比分 |
+| `homeOt3Score` | `String` | 主队加时 3 比分 |
+| `awayOt3Score` | `String` | 客队加时 3 比分 |
+| `round` | `String` | 轮次 |
+| `remainTime` | `String` | 当前节剩余时间 |
+#### 2.3.3 根据球队 ID 查询球队详情
+```text
+GET /skill-api/bk/data/team-info/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `teamId` | `Long` | 是 | 球队 ID |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `teamId` | `Long` | 球队 ID |
+| `teamLogo` | `String` | 球队 logo |
+| `nameEn` | `String` | 英文名 |
+| `nameCn` | `String` | 中文名 |
+| `nameCnShort` | `String` | 中文简称 |
+| `venue` | `String` | 场馆 |
+| `coach` | `String` | 教练 |
+| `country` | `String` | 国家/地区 |
+| `city` | `String` | 城市 |
+| `sport` | `String` | 运动类型 |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+#### 2.3.4 根据球队 ID 查询球队赛程
+```text
+GET /skill-api/bk/data/team-schedule/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `teamId` | `Long` | 是 | 球队 ID |
+| `startDate` | `String` | 否 | 开始日期，格式 `yyyy-MM-dd` |
+| `endDate` | `String` | 否 | 结束日期，格式 `yyyy-MM-dd` |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `matchId` | `Long` | 比赛 ID |
+| `leagueId` | `Long` | 联赛 ID |
+| `leagueName` | `String` | 联赛名称 |
+| `leagueSeasonName` | `String` | 赛季名称 |
+| `stageId` | `Long` | 阶段 ID |
+| `stageName` | `String` | 阶段名称 |
+| `matchTime` | `String` | 比赛时间 |
+| `homeTeamName` | `String` | 主队名称 |
+| `homeTeamId` | `Long` | 主队 ID |
+| `awayTeamName` | `String` | 客队名称 |
+| `awayTeamId` | `Long` | 客队 ID |
+| `homeTeamLogo` | `String` | 主队 logo |
+| `awayTeamLogo` | `String` | 客队 logo |
+| `matchStatus` | `String` | 比赛状态 |
+| `homeScore` | `String` | 主队全场比分 |
+| `awayScore` | `String` | 客队全场比分 |
+| `round` | `String` | 轮次 |
+| `remainTime` | `String` | 当前节剩余时间 |
+补充说明：
+- `startDate` 不传时默认今天 00:00:00
+- `endDate` 不传时默认 `startDate + 7` 天
+- 最大查询跨度为 7 天，单次最多返回 50 场
+- 无数据时返回 `606`
+- 该接口走列表转换逻辑，不返回分节比分与加时比分字段
+#### 2.3.5 根据球队 ID 查询球队阵容
+```text
+GET /skill-api/bk/data/team-squad/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `teamId` | `Long` | 是 | 球队 ID，必须大于 `0` |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `playerId` | `Long` | 球员 ID |
+| `nameCnShort` | `String` | 球员中文简称 |
+| `nameCn` | `String` | 球员中文名 |
+| `nameEn` | `String` | 球员英文名 |
+| `country` | `String` | 国家/地区 |
+| `birthDate` | `String` | 出生日期 |
+| `height` | `String` | 身高（带 cm 单位） |
+| `weight` | `String` | 体重（带 kg 单位） |
+补充说明：
+- 直接通过球队 ID 查询球队下所有球员列表
+- 无数据时返回 `606`
+### 2.4 球员
+#### 2.4.1 根据球员名称模糊查询球员列表
+```text
+GET /skill-api/bk/data/player-query/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `playerName` | `String` | 是 | 球员名称，支持模糊检索 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `playerId` | `Long` | 球员 ID |
+| `nameCnShort` | `String` | 球员中文简称 |
+| `teamId` | `Long` | 所属球队 ID |
+| `teamName` | `String` | 所属球队名称 |
+#### 2.4.2 根据球员 ID 查询球员详情
+```text
+GET /skill-api/bk/data/player-info/v1
+```
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `playerId` | `Long` | 是 | 球员 ID |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `playerId` | `Long` | 球员 ID |
+| `nameEn` | `String` | 英文名 |
+| `nameCn` | `String` | 中文名 |
+| `nameCnShort` | `String` | 中文简称 |
+| `country` | `String` | 国家/地区 |
+| `birthDate` | `String` | 出生日期 |
+| `height` | `String` | 身高 |
+| `weight` | `String` | 体重 |
+| `worth` | `String` | 代码转换后的身价字符串 |
+| `gender` | `String` | 性别 |
+| `teamId` | `Long` | 所属球队 ID（有球队信息时返回） |
+| `teamName` | `String` | 所属球队名称（有球队信息时返回） |
+| `sport` | `String` | 运动类型 |
+## 3. 素材接口
+统一规则：
+- 所有素材接口都必须传 `materialIndexList`
+- `materialIndexList` 支持重复传 query 参数，例如：`?materialIndexList=1&materialIndexList=3`
+- `materialIndexList` 对应常量类：`MaterialIndexDataType`
+- `materialIndexList` 为空，返回 `603`
+- `domain` 不存在，返回 `604`
+- 当前 `domain` 不支持传入的 `materialIndex`，返回 `605`
+- 无法生成 `seasonName` 或 `uniqueKey` 时，返回 `603`
+- 素材为空，返回 `606`
+ - 素材接口统一返回：`List<MaterialData>`
+MaterialDispatcher（`src/main/java/com/ttyingqiu/skillapi/handler/MaterialDispatcher.java`）负责按 `ballType_domain` 分发，domain 不存在立即返回 `604`，`materialIndexList` 为空或定位参数不足会先返回 `603`，在类 `BkAbstractMaterialApi` 中构建 `seasonName`/`uniqueKey` 失败也会映射为 `603`，最终未匹配到素材返回 `606`。
+| domain | 实现类 | 支持的 `materialIndex` |
+| --- | --- | --- |
+| `season-stage` | `com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonStageParamsApi` | `1,3` |
+| `match` | `com.ttyingqiu.skillapi.api.bk.materia.v1.BkMatchIdParamsApi` | `2,4,5,11,12,13,14,15,16,19,21,22,26,29,30,31,32,34,35,62,63,100,101` |
+| `season-team` | `com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonTeamBaseParamsApi` | `9` |
+| `season_team_stat` | `com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonTeamStatParamsApi` | `10` |
+| `match_team_stat` | `com.ttyingqiu.skillapi.api.bk.materia.v1.BkMatchTeamStatParamsApi` | `10` |
+| `season-player` | `com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonPlayerBaseParamsApi` | `7` |
+| `season_player_stat` | `com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonPlayerStatParamsApi` | `8` |
+| `match_player_stat` | `com.ttyingqiu.skillapi.api.bk.materia.v1.BkMatchPlayerStatParamsApi` | `8` |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |
+### 3.1 联赛
+#### 3.1.1 查询联赛基础信息与积分素材
+```text
+GET /skill-api/bk/season-stage/v1
+```
+实现类：`com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonStageParamsApi`
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `materialIndexList` | `List<Integer>` | 是 | 素材索引列表 |
+| `stageId` | `Long` | 否 | 阶段 ID，优先使用 |
+| `seasonId` | `Long` | 否 | 赛季 ID，未传 `stageId` 时使用 |
+支持的 `materialIndexList`：
+| 索引 | 名称 |
+| --- | --- |
+| `1` | 联赛 |
+| `3` | 积分 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |
+### 3.2 比赛
+#### 3.2.1 查询比赛概况、交锋、状态、赔率、情报、阵容、爆料等素材
+```text
+GET /skill-api/bk/match/v1
+```
+实现类：`com.ttyingqiu.skillapi.api.bk.materia.v1.BkMatchIdParamsApi`
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `materialIndexList` | `List<Integer>` | 是 | 素材索引列表 |
+| `matchId` | `Long` | 是 | 比赛 ID |
+支持的 `materialIndexList`：
+| 索引 | 名称 |
+| --- | --- |
+| `2` | 比赛 |
+| `4` | 历史交锋 |
+| `5` | 近期状态 |
+| `11` | 伤停 |
+| `12` | 欧洲赔率 |
+| `13` | 亚洲赔率 |
+| `14` | 大小球赔率 |
+| `15` | 线索 |
+| `16` | 未来赛程 |
+| `19` | 近期状态_盘路 |
+| `21` | 近期状态_盘路_统计 |
+| `22` | 历史交锋_盘路 |
+| `26` | 近期状态_胜负_统计 |
+| `29` | 历史交锋_胜负_统计 |
+| `30` | 近期状态_同主客胜平负_统计 |
+| `31` | 近期状态_同赛事胜平负_统计 |
+| `32` | 近期状态_同主客同赛事胜平负_统计 |
+| `34` | 历史交锋_同赛事胜平负_统计 |
+| `35` | 历史交锋_同主客同赛事胜平负_统计 |
+| `62` | 近10场_球队技术统计_篮球 |
+| `63` | 篮球_球队阵容_上场比赛 |
+| `100` | 赛事爆料 |
+| `101` | 情报局情报 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |
+### 3.3 球队
+#### 3.3.1 查询球队基础信息素材
+```text
+GET /skill-api/bk/season-team/v1
+```
+实现类：`com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonTeamBaseParamsApi`
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `materialIndexList` | `List<Integer>` | 是 | 素材索引列表 |
+| `seasonId` | `Long` | 是 | 赛季 ID |
+| `teamId` | `Long` | 是 | 球队 ID |
+支持的 `materialIndexList`：
+| 索引 | 名称 |
+| --- | --- |
+| `9` | 球队基础信息 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |
+#### 3.3.2 查询赛季球队技术统计素材
+```text
+GET /skill-api/bk/season_team_stat/v1
+```
+实现类：`com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonTeamStatParamsApi`
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `materialIndexList` | `List<Integer>` | 是 | 素材索引列表 |
+| `seasonId` | `Long` | 是 | 赛季 ID |
+| `teamId` | `Long` | 是 | 球队 ID |
+支持的 `materialIndexList`：
+| 索引 | 名称 |
+| --- | --- |
+| `10` | 球队技术统计 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |
+#### 3.3.3 查询比赛球队技术统计素材
+```text
+GET /skill-api/bk/match_team_stat/v1
+```
+实现类：`com.ttyingqiu.skillapi.api.bk.materia.v1.BkMatchTeamStatParamsApi`
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `materialIndexList` | `List<Integer>` | 是 | 素材索引列表 |
+| `matchId` | `Long` | 是 | 比赛 ID |
+| `teamId` | `Long` | 是 | 球队 ID |
+支持的 `materialIndexList`：
+| 索引 | 名称 |
+| --- | --- |
+| `10` | 球队技术统计 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |
+### 3.4 球员
+#### 3.4.1 查询球员基础信息素材
+```text
+GET /skill-api/bk/season-player/v1
+```
+实现类：`com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonPlayerBaseParamsApi`
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `materialIndexList` | `List<Integer>` | 是 | 素材索引列表 |
+| `seasonId` | `Long` | 是 | 赛季 ID |
+| `teamId` | `Long` | 是 | 球队 ID |
+| `playerId` | `Long` | 是 | 球员 ID |
+支持的 `materialIndexList`：
+| 索引 | 名称 |
+| --- | --- |
+| `7` | 球员基础信息 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |
+#### 3.4.2 查询赛季球员技术统计素材
+```text
+GET /skill-api/bk/season_player_stat/v1
+```
+实现类：`com.ttyingqiu.skillapi.api.bk.materia.v1.BkSeasonPlayerStatParamsApi`
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `materialIndexList` | `List<Integer>` | 是 | 素材索引列表 |
+| `seasonId` | `Long` | 是 | 赛季 ID |
+| `playerId` | `Long` | 是 | 球员 ID |
+支持的 `materialIndexList`：
+| 索引 | 名称 |
+| --- | --- |
+| `8` | 球员技术统计 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |
+#### 3.4.3 查询比赛球员技术统计素材
+```text
+GET /skill-api/bk/match_player_stat/v1
+```
+实现类：`com.ttyingqiu.skillapi.api.bk.materia.v1.BkMatchPlayerStatParamsApi`
+请求参数：
+| 参数 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `materialIndexList` | `List<Integer>` | 是 | 素材索引列表 |
+| `matchId` | `Long` | 是 | 比赛 ID |
+| `playerId` | `Long` | 是 | 球员 ID |
+支持的 `materialIndexList`：
+| 索引 | 名称 |
+| --- | --- |
+| `8` | 球员技术统计 |
+返回字段：
+| 字段 | 类型 | 含义 |
+| --- | --- | --- |
+| `materialIndex` | `Integer` | 素材索引 |
+| `materialName` | `String` | 素材名称 |
+| `materialContent` | `JSON / String` | 素材正文，来自 `materialText` 反序列化结果，可能为 JSON 对象、JSON 数组或普通字符串 |
+| `materialDesc` | `String` | 素材描述 |