# The Sports DB

> Access sports data via TheSportsDB (teams, events, scores).

- Skill: `modbender/the-sports-db` (Agent Skill)
- Install (CLI): `npx skillmds@latest add modbender/the-sports-db`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/the-sports-db/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/the-sports-db

---


# TheSportsDB

Free sports database.

## Configuration
Ensure `THE_SPORTS_DB_KEY` is set in `~/.clawdbot/.env`. (Default test key is often `123` or `3`).

## Usage

### Search Team
```bash
curl -s "https://www.thesportsdb.com/api/v1/json/$THE_SPORTS_DB_KEY/searchteams.php?t=Palmeiras"
```

### Last Events (Scores)
Get last 5 events for a team ID:
```bash
curl -s "https://www.thesportsdb.com/api/v1/json/$THE_SPORTS_DB_KEY/eventslast.php?id=134465"
```

### Next Events (Fixtures)
Get next 5 events for a team ID:
```bash
curl -s "https://www.thesportsdb.com/api/v1/json/$THE_SPORTS_DB_KEY/eventsnext.php?id=134465"
```

**Note:** Rate limit is 30 requests/minute.