Agent Skill

worldcup-analyzer

World Cup Analyzer 是一个面向国家队世界杯比赛的 Agent Skill:封装远程机器学习预测接口,输出胜平负、预期净胜球、赛程/赛果上下文,并内置临时 Key、配额提醒和反投注合规约束。

数据分析·dataTrevor·来自 skill_cn·github.com ↗
npx skills add dataTrevor/worldcup-analyzer
2 Stars·11 下载量·1k 综合热度·4,151 字文档·源站更新 2026-08-24

README 文档

4,151 字

worldcup-analyzer

<img src="https://img.shields.io/badge/ClawHub-worldcup--analyzer-blue" alt="ClawHub"> Python License

Mira/Claude-Code Skill for football match prediction using the remote machine learning API at https://www.jiajielitong.com. The project keeps the original worldcup-analyzer name for published-user continuity, but the default experience is now English Premier League first. World Cup national-team matchups remain supported.

Statistical analysis only. Not betting advice.

Layout

worldcup-analyzer/
├── SKILL.md
├── README.md
├── skill-card.md
├── requirements.txt
├── scripts/
│   └── wc_client.py
├── references/
│   ├── api.md
│   ├── team_names.md
│   ├── compliance.md
│   └── schedule.md
└── evals/
    ├── evals.json
    └── run_evals.py

Quick Start

export SOCCER_API_KEY="your_key_here"   # optional permanent key
export WORLDCUP_API_BASE="https://www.jiajielitong.com"   # optional default
pip install -r requirements.txt
python3 evals/run_evals.py

No permanent key? Agent Skill users can still try the simulation API. The client automatically requests a 24-hour temporary key from POST /matches/agent/temp-key. It includes 2 free simulation queries per day. Repeating the exact same home/away fixture within 3 days does not consume additional credits. When the temp-key limit is reached, register or renew a permanent API key at https://www.jiajielitong.com.

Client Helpers

FunctionPurpose
requestagenttemp_key()Requests a 24-hour Agent temporary key; cached in process only.
simulateeplmatch(home, away, match_date=None, season="2026-27")EPL outcome + expected goal diff via /matches/epl/simulate/.
listeplschedule()EPL schedule payload via /matches/epl/schedule/.
listeplteams()EPL team names inferred from the schedule payload.
predict_match(home, away, competition="epl")Compatibility wrapper. Defaults to EPL; pass "worldcup" for national-team World Cup matchups.
list_teams(competition="epl")EPL teams by default; World Cup national teams when competition="worldcup".
validate_team(name, competition="epl")(True, canonical) or (False, fuzzy_suggestion).
format_prediction(data, language="en")Margin-aware renderer with mandatory disclaimer. Flags near-draws when `win_goals< 0.20`.
firstusemessage(language="zh")First-use onboarding text with free-trial, repeat-credit, model-data, and API-key guidance.
quota_warning(data, language="zh")Warns near/at finite quota limits and points users to https://www.jiajielitong.com.
cache_clear()Resets process-local cache.

Demo

ClawHub page: https://clawhub.ai/datatrevor/skills/worldcup-analyzer

English EPL prompt:

User: Predict Arsenal vs Chelsea in the Premier League.

Example output:

**Arsenal vs Chelsea** (modeled projection)

- Outcome from Arsenal's POV: Win
- Expected goal difference (home - away): +0.18
- Interpretation: model projects a near-draw; marginal lean toward Arsenal
- Schedule: kickoff time is included when available; final result is shown for completed fixtures

Statistical reference only. Not betting advice. 18+.

Chinese EPL prompt:

用户:英超曼城主场对阿森纳,谁更占优?

Example output:

**Man City vs Arsenal**(模型预测)

- 从 Man City 视角看的赛果:Win
- 预期净胜球(主队 - 客队):+0.21
- 解读:模型偏向主场的 Man City
- 赛程:若赛程接口已公布,将附上开赛时间;若比赛已结束,将附上最终赛果

仅供统计参考,不构成投注建议。18+。

World Cup compatibility prompt:

用户:巴西主场对摩洛哥,世界杯谁更有可能赢?

World Cup fixtures still use Wikipedia first and Baidu Baike as fallback for kickoff/final-result context.

Compliance

  • No phrases like recommended bet, sure win, lock, tips, 稳赢, 推荐.
  • Disclaimer is automatic and must not be stripped.
  • Refuse betting picks, stake sizing, bookmaker odds, and under-18 use.

See references/compliance.md for full text and refusal templates.

Changelog

1.1.1

Republished EPL-first version to refresh the ClawHub latest tag and update the marketplace listing to the current EPL-first description.

1.1.0

English: Added EPL-first support through /matches/epl/simulate/ and /matches/epl/schedule/, while preserving World Cup national-team support under the existing Skill name and repository. Updated onboarding, temporary-key credit messaging, schedule handling, and marketplace copy.

中文:新增英超优先支持,调用 /matches/epl/simulate/ 做比赛预测,并通过 /matches/epl/schedule/ 获取赛程上下文;同时保留世界杯国家队预测能力,沿用 现有 Skill 名称和仓库,避免用户重新认识一个新项目。本版本同步强化首次使用提示、 临时 key 免费额度说明、3 天内重复查询不扣 credits 的提示,以及发布页文案。

1.0.3

English: World Cup-focused prediction flow with bilingual formatting, near-draw handling at |win_goals| < 0.20, automatic Agent temporary keys, and Wikipedia/Baidu schedule fallback.

中文:以世界杯预测为主,支持中英文输出、|win_goals| < 0.20 的近似平局展示、 Agent 临时 key 自动申请,以及 Wikipedia/Baidu 赛程降级查询。

同分类其他技能

查看全部 ›