← Back to Skills Marketplace
bettermen

Football Data Hub

by bettermen · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
29
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install football-data-hub
Description
足球数据库查询助手。查询积分榜、赛程赛果、球队球员数据、赛前H2H预览。纯信息查询不涉及博彩。触发词:足球积分榜、查赛程、球队信息、球员数据、足球数据、H2H、赛前分析、football standings、查排名、联赛数据。
README (SKILL.md)

Football Data Hub - 足球数据库

⚽ 零配置足球数据查询技能。立即可用,无需任何 API Key。

数据源策略(三级降级)

  1. OpenLigaDB(默认,零配置)— 完全免费无需认证,覆盖德甲/德乙/德丙/欧冠/欧联等主要联赛
  2. API-Football(需配置 RapidAPI Key)— 1200+ 联赛,球员数据,实时比分,H2H
  3. football-data.org(需配置 Key)— 12 大联赛,射手榜,比赛详情

零配置直接可用

# 积分榜
python scripts/fetch_football_data.py --endpoint standings --league "德甲" --season 2025

# 赛程/赛果
python scripts/fetch_football_data.py --endpoint fixtures --league "德甲" --season 2025
python scripts/fetch_football_data.py --endpoint fixtures --league "德甲" --matchday 1

# 球队搜索
python scripts/fetch_football_data.py --endpoint teams --search "Bayern"

# 球队列表
python scripts/fetch_football_data.py --endpoint teams --league "德甲"

# 联赛列表
python scripts/fetch_football_data.py --endpoint leagues --search "Champions"

支持联赛 (OpenLigaDB)

快捷名 联赛 状态
bl1 / 德甲 德甲 2025/26 ✅ 积分榜+赛程完整
bl2 德乙
bl3 德丙
dfb 德国杯
ucl / 欧冠 欧冠
el / 欧联 欧联

💡 用 --endpoint leagues 查看完整列表

升级到 API-Football(可选)

配置 config.yaml 后可解锁:

  • ✅ 球员数据(射手、助攻统计)
  • ✅ H2H 历史交锋分析
  • ✅ 英超、西甲、意甲、法甲等全球 1200+ 联赛
  • ✅ 实时比分
cp config.example.yaml config.yaml
# 编辑 config.yaml 填入 RapidAPI Key

核心原则

  • 纯信息查询,不涉及博彩预测 — 与 soccer-lottery 明确区分
  • 零配置优先 — OpenLigaDB 无需任何 Key,开箱即用
  • 中文友好 — 支持 德甲 欧冠 欧联 等中文名直接查询

触发词

查积分榜、查赛程、球队信息、球员数据、H2H、赛前分析、足球数据、查排名、联赛数据、football standings

Usage Guidance
Install only if you are comfortable with the skill querying external football APIs and, if configured, storing API keys in a local config.yaml. For safer use, pin reviewed dependency versions and do not rely on the H2H preview for decisions until its import and win-counting bugs are fixed.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The artifacts consistently describe football standings, fixtures, teams, player data, and H2H lookup. The main script performs fixed-host HTTP queries to OpenLigaDB and optional football APIs; the H2H preview script appears broken and has an accuracy bug, but that is a reliability issue rather than malicious behavior.
Instruction Scope
Runtime instructions are mostly scoped to running the included Python scripts and optionally creating a local config.yaml. The allowed tools include Write/Edit/Bash/WebFetch/WebSearch, which is broader than the current implementation needs, but the skill text does not instruct hidden mutation or unrelated access.
Install Mechanism
Installation is ordinary Python dependency installation with requests and pyyaml. The requirements use lower-bound ranges rather than exact pins, so installs are less reproducible, but this is not enough by itself to require Review.
Credentials
Network access to football-data providers is expected for the stated purpose. The code uses fixed API hosts and does not show arbitrary URL fetching, broad local indexing, destructive actions, or unrelated file access.
Persistence & Privilege
The only expected persistence is an optional local config.yaml containing user-provided API keys. API keys are sent to their intended providers via request headers; no background workers, credential harvesting, privilege escalation, or hidden persistence were found.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install football-data-hub
  3. After installation, invoke the skill by name or use /football-data-hub
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: zero-config football data query. Standings, fixtures, teams via OpenLigaDB. No API key needed.
Metadata
Slug football-data-hub
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Football Data Hub?

足球数据库查询助手。查询积分榜、赛程赛果、球队球员数据、赛前H2H预览。纯信息查询不涉及博彩。触发词:足球积分榜、查赛程、球队信息、球员数据、足球数据、H2H、赛前分析、football standings、查排名、联赛数据。 It is an AI Agent Skill for Claude Code / OpenClaw, with 29 downloads so far.

How do I install Football Data Hub?

Run "/install football-data-hub" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Football Data Hub free?

Yes, Football Data Hub is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Football Data Hub support?

Football Data Hub is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Football Data Hub?

It is built and maintained by bettermen (@bettermen); the current version is v1.0.0.

💬 Comments