Metadata

name: juhe-football-query
description: 足球联赛查询。查询各大足球联赛的赛事赛程和积分榜，支持中超、英超、意甲、德甲、法甲、西乙、苏超等联赛。使用场景：用户说"查一下英超赛程"、"中超积分榜"、"德甲比赛结果"、"意甲最新排名"等。通过聚合数据（juhe.cn）API 实时查询，免费注册每天免费调用。
homepage: https://www.juhe.cn/docs/api/id/90
metadata: {"openclaw":{"emoji":"⚽","requires":{"bins":["python3"],"env":["JUHE_FOOTBALL_KEY"]},"primaryEnv":"JUHE_FOOTBALL_KEY"}}

足球联赛查询

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

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

前置配置：获取 API Key

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

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

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

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

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

使用方法

查询联赛赛程

# 查询中超赛程
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

查询积分榜

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

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

直接调用 API（无需脚本）

# 查询赛事赛程
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 使用指南

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

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

返回字段说明

赛事赛程接口：

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

积分榜接口：

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

错误处理

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

脚本位置

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

关于聚合数据

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

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

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

足球联赛查询 - 聚合数据

安装技能