球云体育 Sports Data

查询某一天的全部赛程与比分，覆盖足球、篮球、网球、棒球等项目的全部联赛与杯赛。用户问「今天有什么比赛」「昨天的赛果」「周末的赛程」时用这个工具。date 省略时返回今天（东八区）的赛程，可查询范围为往前 365 天至往后 7 天。只想知道此刻正在踢的比赛，请改用 get_live_matches。

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "日期，格式 YYYY-MM-DD（东八区自然日），例如 2026-09-28。省略则取今天。",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "additionalProperties": false
}

返回此刻正在进行（含中场休息）的全部比赛及其实时比分与进行分钟数。用户问「现在有什么比赛在踢」「实时比分」时用这个工具。注意跨零点的比赛：欧洲联赛常在东八区凌晨进行，这类比赛不会出现在今天的 get_matches_by_date 结果里，只能靠本工具拿到。

{
  "type": "object",
  "additionalProperties": false
}

返回单场比赛的完整信息，包含比分、状态、场地、轮次，以及按分钟排列的事件时间轴（进球、红黄牌、换人、VAR）。用户问某场比赛「谁进的球」「第几分钟进的」「详细过程」时用这个工具。matchId 从 get_matches_by_date 或 get_live_matches 的返回结果里取。

{
  "type": "object",
  "properties": {
    "matchId": {
      "type": "string",
      "description": "比赛 id（数字，与比赛页 /match/{matchId} 相同），例如 13376006。"
    }
  },
  "required": [
    "matchId"
  ],
  "additionalProperties": false
}

返回指定联赛的完整积分榜，含排名、场次、胜平负、进失球、净胜球、积分与近五场战绩。用户问「英超积分榜」「西甲第几名」「谁是榜首」时用这个工具。热门联赛（英超、西甲、意甲、德甲、法甲、欧冠、中超等）提供积分榜；没有积分榜的赛事会返回错误提示。

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "description": "联赛 id，例如 epl（英超）、laliga（西甲）、seriea（意甲）、bundesliga（德甲）、ligue1（法甲）、ucl（欧冠）、csl（中超）。完整清单见 /llms-full.txt。"
    }
  },
  "required": [
    "league"
  ],
  "additionalProperties": false
}

返回单支球队的联赛排名、赛季战绩、近五场状态、最近已结束的比赛与未来赛程。用户问「阿森纳最近怎么样」「曼城下一场打谁」「某队排第几」时用这个工具。teamId 是数字 id（与球队页 /team/{teamId} 相同），可从 get_matches_by_date 的 home.id / away.id 或 get_standings 的 teamId 取得。

{
  "type": "object",
  "properties": {
    "teamId": {
      "type": "string",
      "description": "球队 id（数字），例如 10462（成都蓉城）。"
    }
  },
  "required": [
    "teamId"
  ],
  "additionalProperties": false
}

按关键词检索站内报道，命中标题、摘要、正文、标签与分类。用户问「有没有关于某队的报道」「最新的转会新闻」时用这个工具。query 省略时返回全部报道（按发布时间倒序），适合「最近有什么新闻」这类开放提问。分类固定为转会、战报、伤情、数据、评论五种。

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "检索关键词，例如「阿森纳」「转会」「xG」。省略则返回全部报道。"
    }
  },
  "additionalProperties": false
}