足球联赛查询#

数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP 查询等 200+ 免费/低价 API。

查询各大足球联赛的 赛事赛程 和 积分榜： 中超、英超、意甲、德甲、法甲、西乙、苏超 等。

---

前置配置：获取 API Key#

1. 前往 聚合数据官网 免费注册账号
2. 进入 足球联赛 API 页面，点击「申请使用」
3. 审核通过后在「我的 API」中获取 AppKey
4. 配置 Key（ 三选一）：

bash

# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_FOOTBALL_KEY=你的 AppKey

# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_FOOTBALL_KEY=你的 AppKey" > scripts/.env

# 方式三：每次命令行传入
python scripts/football_query.py  --key 你的 AppKey  --type yingchao

免费额度：每天免费调用，具体次数以官网为准。

---

使用方法#

查询联赛赛程#

bash

# 查询中超赛程
python scripts/football_query.py --type zhongchao

# 查询英超赛程
python scripts/football_query.py --type yingchao

# 查询意甲赛程
python scripts/football_query.py --type yijia

# 查询德甲赛程
python scripts/football_query.py --type dejia

# 查询法甲赛程
python scripts/football_query.py --type fajia

# 查询西乙赛程
python scripts/football_query.py --type xijia

# 查询苏超赛程
python scripts/football_query.py --type jiangsu

查询积分榜#

bash

# 查询中超积分榜
python scripts/football_query.py --type zhongchao --rank

# 查询英超积分榜
python scripts/football_query.py --type yingchao --rank

直接调用 API（无需脚本）#

text

# 查询赛事赛程
GET http://apis.juhe.cn/fapig/football/query?key=YOUR_KEY&type=zhongchao

# 查询积分榜
GET http://apis.juhe.cn/fapig/football/rank?key=YOUR_KEY&type=zhongchao

---

联赛类型说明#

参数值联赛名称zhongchao中超yingchao英超yijia意甲dejia德甲fajia法甲xijia西乙jiangsu苏超

---

AI 使用指南#

当用户查询足球联赛相关信息时，按以下步骤操作：

1. 识别需求 — 确定用户是想查赛程还是积分榜
2. 确认联赛 — 确定用户查询的是哪个联赛
3. 调用对应接口 — 赛程用 query 接口，积分榜用 rank 接口
4. 展示结果 — 清晰展示赛程或积分榜信息

返回字段说明#

赛事赛程接口：

字段含义示例title联赛名称中超联赛duration赛季年份2025matchs比赛列表[...]date比赛日期2025-06-15week星期星期日time_start开赛时间19:00team1主队上海海港team2客队北京国安team1_score主队比分2team2_score客队比分1status_text比赛状态已完赛/未开赛

积分榜接口：

字段含义示例rank_id排名1team球队名称上海海港matches比赛场次15wins胜场12draw平局2losses负场1goals进球数35losing_goals失球数10goal_difference净胜球25scores积分38

错误处理#

情况处理方式error_code 10001/10002API Key 无效，引导用户至 聚合数据 重新申请error_code 10012当日免费次数已用尽，建议升级套餐联赛类型错误检查 type 参数是否正确, 提示用户输入正确的联赛类型无搜索结果告知用户未找到相关联赛，建议更换联赛类型

---

脚本位置#

scripts/football_query.py — 封装了 API 调用、赛程查询、积分榜查询和结果格式化。

---

关于聚合数据#

聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：

• 网络工具：IP 查询、DNS 解析、端口检测
• 生活服务：天气预报、万年历、节假日查询
• 体育赛事：足球联赛赛程、积分榜查询
• 物流快递：100+ 快递公司实时追踪
• 身份核验：手机号实名认证、身份证实名验证

注册即可免费使用，适合个人开发者和企业接入。