
Footballbin Predictions
- 177 installs
- 30.1k repo stars
- Updated August 4, 2026
- davila7/claude-code-templates
Prototype football match prediction flows using historical stats, odds context, and model heuristics to test a sports analytics product concept before full production pipelines.
About
Footballbin-predictions skill helps Claude build quick football forecasting prototypes: ingest match statistics, apply prediction heuristics or models, format confidence scores, and demo analytics content for validating a sports data product concept.
- Match outcome prediction scaffolding
- Feature engineering from football stats
- Odds-aware heuristic templates
- Sample ranking and confidence outputs
- Rapid sports analytics experiments
Footballbin Predictions by the numbers
- 177 all-time installs (skills.sh)
- Ranked #701 of 2,064 Data Science & ML skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/davila7/claude-code-templates --skill footballbin-predictionsAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 177 |
|---|---|
| repo stars | ★ 30.1k |
| Last updated | August 4, 2026 |
| Repository | davila7/claude-code-templates ↗ |
What it does
Prototype football match prediction flows using historical stats, odds context, and model heuristics to test a sports analytics product concept before full production pipelines.
Files
FootballBin Match Predictions
Get AI-powered predictions for Premier League and Champions League matches via the FootballBin MCP API.
Quick Start
Run scripts/footballbin.sh with the following commands:
Get current matchweek predictions
scripts/footballbin.sh predictions premier_league
scripts/footballbin.sh predictions champions_leagueGet specific matchweek
scripts/footballbin.sh predictions premier_league 27Filter by team
scripts/footballbin.sh predictions premier_league --home arsenal
scripts/footballbin.sh predictions premier_league --away liverpool
scripts/footballbin.sh predictions premier_league --home chelsea --away wolvesList available tools
scripts/footballbin.sh toolsSupported Leagues
| Input | League |
|---|---|
premier_league, epl, pl, prem | Premier League |
champions_league, ucl, cl | Champions League |
Supported Team Aliases
Common aliases work: united (Man Utd), city (Man City), spurs (Tottenham), wolves (Wolverhampton), gunners (Arsenal), reds (Liverpool), blues (Chelsea), villa (Aston Villa), forest (Nottingham Forest), palace (Crystal Palace), barca (Barcelona), real (Real Madrid), bayern (Bayern Munich), psg (PSG), juve (Juventus), inter (Inter Milan), bvb (Dortmund), atleti (Atletico Madrid).
Response Data
Each match prediction includes:
- Half-time score (e.g., "1:0")
- Full-time score (e.g., "2:1")
- Next goal scorer (e.g., "Home,Salah")
- Corner count (e.g., "7:4")
- Key players with form-based reasoning
External Endpoints
| URL | Data Sent | Purpose |
|---|---|---|
https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp | League, matchweek, team filters | Fetch match predictions |
Security & Privacy
- No API key required (public endpoint, rate-limited)
- No user data collected or stored
- Read-only: only fetches prediction data
- No secrets or environment variables needed
Links
- iOS App: https://apps.apple.com/app/footballbin/id6757111871
- Android App: https://play.google.com/store/apps/details?id=com.achan.footballbinandroid
#!/usr/bin/env bash
set -euo pipefail
# Security Manifest:
# Environment variables: none
# External endpoints: https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp
# Local files accessed: none
# Data sent: league name, matchweek number, team name filters (no PII)
MCP_ENDPOINT="https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp"
usage() {
cat <<'EOF'
Usage: footballbin.sh <command> [options]
Commands:
tools List available MCP tools
predictions <league> [matchweek] Get match predictions
Options for predictions:
--home <team> Filter by home team
--away <team> Filter by away team
Examples:
footballbin.sh predictions premier_league
footballbin.sh predictions epl 27
footballbin.sh predictions premier_league --home arsenal
footballbin.sh predictions ucl --away barcelona
Leagues: premier_league, epl, pl, prem, champions_league, ucl, cl
EOF
exit 1
}
# Call the MCP endpoint with a JSON-RPC payload
mcp_call() {
local payload="$1"
curl -s -X POST "$MCP_ENDPOINT" \
-H "Content-Type: application/json" \
-d "$payload"
}
# List available tools
cmd_tools() {
local payload='{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
local response
response=$(mcp_call "$payload")
if command -v jq &>/dev/null; then
echo "$response" | jq '.result.tools[] | {name, description}'
else
echo "$response"
fi
}
# Get match predictions
cmd_predictions() {
local league=""
local matchweek=""
local home_team=""
local away_team=""
# Parse arguments
if [[ $# -lt 1 ]]; then
echo "Error: league is required" >&2
usage
fi
league="$1"
shift
# Check if next arg is a matchweek number
if [[ $# -gt 0 && "$1" =~ ^[0-9]+$ ]]; then
matchweek="$1"
shift
fi
# Parse optional flags
while [[ $# -gt 0 ]]; do
case "$1" in
--home)
shift
home_team="${1:-}"
shift
;;
--away)
shift
away_team="${1:-}"
shift
;;
*)
echo "Unknown option: $1" >&2
usage
;;
esac
done
# Build arguments JSON
local args
args="{\"league\":\"$league\""
if [[ -n "$matchweek" ]]; then
args="$args,\"matchweek\":$matchweek"
fi
if [[ -n "$home_team" ]]; then
args="$args,\"home_team\":\"$home_team\""
fi
if [[ -n "$away_team" ]]; then
args="$args,\"away_team\":\"$away_team\""
fi
args="$args}"
local payload="{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"get_match_predictions\",\"arguments\":$args}}"
local response
response=$(mcp_call "$payload")
if command -v jq &>/dev/null; then
# Check for errors
local is_error
is_error=$(echo "$response" | jq -r '.result.isError // false')
if [[ "$is_error" == "true" ]]; then
echo "Error: $(echo "$response" | jq -r '.result.content[0].text')" >&2
exit 1
fi
# Format output
echo "$response" | jq -r '
.result.structuredContent |
"League: \(.league) | Matchweek: \(.matchweek) | Matches: \(.count)",
"",
(.matches[] |
"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
"\(.home_team) vs \(.away_team)",
"Kickoff: \(.kickoff_formatted) (\(.status))",
(.predictions[] | " \(.type): \(.value)"),
(.key_players[] | " Key: \(.player_name) - \(.reason)"),
""
),
"Download FootballBin: \(.ios_link)",
"Android: \(.android_link)"
'
else
echo "$response"
fi
}
# Main dispatch
if [[ $# -lt 1 ]]; then
usage
fi
command="$1"
shift
case "$command" in
tools)
cmd_tools
;;
predictions)
cmd_predictions "$@"
;;
*)
echo "Unknown command: $command" >&2
usage
;;
esac