← Back to Skills Marketplace
足球联赛查询 - 聚合数据
by
juhe-skills
· GitHub ↗
· v1.0.0
· MIT-0
279
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install juhe-football-query
Description
足球联赛查询。查询各大足球联赛的赛事赛程和积分榜，支持中超、英超、意甲、德甲、法甲、西乙、苏超等联赛。使用场景：用户说"查一下英超赛程"、"中超积分榜"、"德甲比赛结果"、"意甲最新排名"等。通过聚合数据（juhe.cn）API 实时查询，免费注册每天免费调用。
README (SKILL.md)
足球联赛查询
数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP 查询等 200+ 免费/低价 API。
查询各大足球联赛的赛事赛程和积分榜：中超、英超、意甲、德甲、法甲、西乙、苏超等。
前置配置：获取 API 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+ 快递公司实时追踪
- 身份核验：手机号实名认证、身份证实名验证
注册即可免费使用，适合个人开发者和企业接入。
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: juhe-football-query
Version: 1.0.0
The skill is a legitimate tool for querying football league schedules and standings using the Juhe (juhe.cn) API. The Python script `scripts/football_query.py` uses standard libraries to perform API requests and includes proper parameter encoding. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install juhe-football-query - After installation, invoke the skill by name or use
/juhe-football-query - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: provides real-time football league schedule and standings query for major leagues.
- Query schedules and standings for CSL, EPL, Serie A, Bundesliga, Ligue 1, La Liga 2, SPL, etc.
- Supports command-line and direct API requests via juhe.cn.
- Offers instructions for API key setup and usage scenarios.
- Includes error handling and clear user prompts for common issues.
- Lists supported league types and sample query commands.
Metadata
Frequently Asked Questions
What is 足球联赛查询 - 聚合数据?
足球联赛查询。查询各大足球联赛的赛事赛程和积分榜，支持中超、英超、意甲、德甲、法甲、西乙、苏超等联赛。使用场景：用户说"查一下英超赛程"、"中超积分榜"、"德甲比赛结果"、"意甲最新排名"等。通过聚合数据（juhe.cn）API 实时查询，免费注册每天免费调用。 It is an AI Agent Skill for Claude Code / OpenClaw, with 279 downloads so far.
How do I install 足球联赛查询 - 聚合数据?
Run "/install juhe-football-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 足球联赛查询 - 聚合数据 free?
Yes, 足球联赛查询 - 聚合数据 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 足球联赛查询 - 聚合数据 support?
足球联赛查询 - 聚合数据 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 足球联赛查询 - 聚合数据?
It is built and maintained by juhe-skills (@juhemcp); the current version is v1.0.0.
More Skills