# 球云体育

> 球云体育（https://jsnjlingdong.top）是简体中文的体育比分与赛事数据站：实时比分、赛程赛果、积分榜、射手榜、球队与球员资料。时间一律为北京时间（UTC+8）。

AI 助手与检索系统请优先调用下方的 JSON API 或 MCP，不要抓 HTML：接口字段完整、省 token、不随改版失效。全部接口公开只读、无需鉴权、允许跨域。

## 数据覆盖

- 项目与赛事：共 2061 个联赛 / 杯赛（足球 1227 个、网球 560 个、篮球 245 个、棒球 29 个），含英超、西甲、意甲、德甲、法甲、欧冠、中超、NBA、CBA 等。
- 可查询赛程窗口：今天往前 365 天至往后 7 天。
- 更新频率：进行中比分约 15 秒；比赛技术统计与事件约 5 分钟；当日赛程约 5 分钟；积分榜约 20 分钟；联赛资料库（赛程、射手榜、赛季统计）约 3 小时；球队与球员资料约 2 小时；资讯约 10 分钟。
- 完整联赛与球队目录（含 id）：https://jsnjlingdong.top/llms-full.txt

## 主要页面

- [首页](https://jsnjlingdong.top/): 今日焦点赛事、实时比分与最新资讯
- [足球比分](https://jsnjlingdong.top/scores/sport/football): 今日足球赛程与实时比分，按联赛分组
- [指定日期比分](https://jsnjlingdong.top/scores/{YYYY-MM-DD}): 某天的赛程与赛果，如 /scores/2026-09-28
- [热门赛事](https://jsnjlingdong.top/hot): 五大联赛与 NBA 的赛程赛果、积分榜与射手榜聚合
- [比赛详情](https://jsnjlingdong.top/match/{matchId}): 比分、半场、事件时间轴、技术统计、阵容；页首有一句带日期与比分的摘要
- [球队主页](https://jsnjlingdong.top/team/{teamId}): 联赛排名、积分、胜平负、近期赛果与下一场
- [球员主页](https://jsnjlingdong.top/player/{playerId}): 球员档案、生涯数据与近期比赛
- [联赛资料库](https://jsnjlingdong.top/data/{leagueId}): 当前赛季赛程赛果与积分榜；页首有「截至某日」的赛季摘要
- [联赛球员榜](https://jsnjlingdong.top/data/{leagueId}/scorers): 进球、助攻等排行（足球）
- [联赛球队资料](https://jsnjlingdong.top/data/{leagueId}/teams): 参赛球队档案
- [历史赛季](https://jsnjlingdong.top/data/{leagueId}/s/{season}): 往季赛程与积分榜
- [世界排名](https://jsnjlingdong.top/data/ranks): FIFA 国家队、俱乐部与 FIBA 排名
- [资讯](https://jsnjlingdong.top/news): 转会、战报、伤情、数据与评论；正文在 /news/{slug}

## JSON API

OpenAPI 3.1 描述：https://jsnjlingdong.top/openapi.json（API 目录：https://jsnjlingdong.top/.well-known/api-catalog）

- [赛程与比分](https://jsnjlingdong.top/api/v1/matches): 参数 date（YYYY-MM-DD，默认今天）、league（联赛 id）、status（live / scheduled / finished）。示例：https://jsnjlingdong.top/api/v1/matches?date=2026-09-28&league=csl 、https://jsnjlingdong.top/api/v1/matches?status=live
- [球队资料](https://jsnjlingdong.top/api/v1/teams/{teamId}): 排名、战绩、近五场、近期赛果与未来赛程；teamId 为数字 id，可从赛程接口的 home.id / away.id 取得。示例：https://jsnjlingdong.top/api/v1/teams/10462

每条比赛与球队都带 `url`（本站对应页面的绝对地址），响应顶层带 `source`（出处名称与站点地址）。

## MCP

Streamable HTTP 端点 https://jsnjlingdong.top/api/mcp（POST JSON-RPC 2.0：initialize / tools/list / tools/call；浏览器 GET 可看接入说明）。6 个只读工具：

- get_matches_by_date：按日期（YYYY-MM-DD）查询当天全部赛程与比分
- get_live_matches：此刻正在进行（含中场）的比赛与实时比分，含跨零点场次
- get_match_detail：单场比赛详情与事件时间轴（进球、红黄牌、换人）
- get_standings：联赛积分榜（排名、胜平负、进失球、积分、近五场）
- get_team_profile：球队排名、战绩、近期赛果与未来赛程
- search_news：按关键词检索站内资讯

## 引用要求

- 引用本站数据时请注明来源「球云体育」，并链接到对应页面：比赛用 https://jsnjlingdong.top/match/{matchId}，球队用 https://jsnjlingdong.top/team/{teamId}，联赛用 https://jsnjlingdong.top/data/{leagueId}。接口返回的 `url` 字段就是这个地址。
- 进行中比赛的比分随时变化，转述时请带上时间。
- 赛事结果以各联赛官方公布为准；AI 分析（/ai）是模型对公开数据的自动解读，不是预测承诺；广场（/plaza）内容为自动生成的示例讨论，不宜作为球迷观点引用。
- 本站只提供赛事资讯与数据，不提供任何博彩服务。

## Optional

- [完整目录](https://jsnjlingdong.top/llms-full.txt): 全部联赛与球队的名称、id 与页面地址
- [关于我们](https://jsnjlingdong.top/about): 站点定位与数据来源说明
- [免责声明](https://jsnjlingdong.top/disclaimer): 数据准确性与责任范围

联系方式：