足球联赛查询 - 聚合数据

足球联赛查询。查询各大足球联赛的赛事赛程和积分榜，支持中超、英超、意甲、德甲、法甲、西乙、苏超等联赛。使用场景：用户说"查一下英超赛程"、"中超积分榜"、"德甲比赛结果"、"意甲最新排名"等。通过聚合数据（juhe.cn）API 实时查询，免费注册每天免费调用。

Security Scan

The skill is internally consistent with its stated purpose (querying football data from juhe.cn) and only requires a single API key and python3, but it sends that key in plain HTTP query strings which risks exposure.

Purpose & Capability

Name/description, SKILL.md, and the included Python script all consistently implement querying juhe.cn football APIs for schedules and rankings. Required items (python3 and JUHE_FOOTBALL_KEY) are appropriate for the stated functionality.

Instruction Scope

Instructions are narrowly scoped to identify league/type, call the appropriate juhe.cn endpoints, and format results. However, the script and SKILL.md use http://apis.juhe.cn (HTTP) for requests, sending the API key in the URL query string — this is a security concern (key may be exposed in transit, in logs, or via network intermediaries).

Install Mechanism

This is an instruction-only skill with a small included script and no install spec; nothing is downloaded or written to disk by an installer. Required binary python3 is reasonable.

Credentials

Only JUHE_FOOTBALL_KEY is required (declared as primary credential), which is proportional. The concern is not extra credentials but that the key is placed in query parameters and transmitted over plain HTTP by default, increasing risk of key leakage. The script also supports .env files (script-local) and CLI key arg as advertised.

Persistence & Privilege

always is false and the skill does not request persistent system-wide privileges or modify other skills' configs. It operates within its own scope.

Assessment

This skill appears to do exactly what it claims: query juhe.cn football APIs and format results. Before installing or using it, consider the following: - Security of the API key: the script uses HTTP endpoints and places your JUHE_FOOTBALL_KEY in the URL query string. That can expose the key in transit or in intermediate logs. Check whether juhe.cn supports HTTPS for these endpoints and update QUERY_API_URL and RANK_API_URL to use https:// if available. - Prefer configuring the API key via an environment variable (export JUHE_FOOTBALL_KEY) rather than a scripts/.env file to avoid accidentally committing secrets to source control. - Rotate the API key if it may have been exposed, and follow juhe.cn guidance for limiting key scope/quota where possible. - The script prints results and JSON to stdout; there are no hidden external endpoints or obfuscated code in the included file. It does not request additional unrelated credentials. If you want to eliminate the main risk: edit the script to use HTTPS endpoints (or confirm provider supports TLS) and avoid passing the key in URLs (use POST with headers if the API supports it). Otherwise the skill is coherent and functional for the described purpose.

足球联赛查询

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

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

---

前置配置：获取 API Key

1. 前往 聚合数据官网 免费注册账号
2. 进入 足球联赛 API 页面，点击「申请使用」
3. 审核通过后在「我的 API」中获取 AppKey
4. 配置 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 使用指南

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

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

返回字段说明

赛事赛程接口：

字段	含义	示例
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+ 快递公司实时追踪
• 身份核验：手机号实名认证、身份证实名验证

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