# skore.info

> skore.info helps people find sports games worth watching without seeing the score first.

## What to use first

- Use https://skore.info/.well-known/openapi.json for the public JSON schema.
- Use https://skore.info/.well-known/api-catalog for API discovery.
- Use https://skore.info/.well-known/agent-skills/index.json for higher-level task guidance.

## Primary user routes

- https://skore.info/ : homepage and sport entry points.
- https://skore.info/sport/nba : spoiler-free NBA games.
- https://skore.info/sport/soccer : spoiler-free soccer matches.
- https://skore.info/sport/nfl : spoiler-free NFL games.
- https://skore.info/sport/mlb : spoiler-free MLB games.
- https://skore.info/sport/nhl : spoiler-free NHL games.
- https://skore.info/blog : sports blog index.
- https://skore.info/faq : product FAQ.
- Blog posts use https://skore.info/blog/YYYY/MM/DD/slug.

## Public JSON feeds

- https://skore.info/api/games.json
  - Canonical read-only game feed used by the frontend.
  - Top-level shape: `lastUpdated`, `games`.
  - `games` is grouped by sport key: `nba`, `soccer`, `nfl`, `mlb`, `nhl`.
  - Each sport contains a dictionary keyed by game id.
  - Game objects include teams, scores, competition, status, UTC datetime, and optional recap URL.

- https://skore.info/api/blog/posts.json
  - Generated metadata for recent blog posts.
  - Each entry includes title, description, date, thumbnail, tags, slug, and reading time.

- https://skore.info/api/status.json
  - Lightweight status and discovery summary for the public frontend resources.

## Sport filter semantics

- `nba`, `nfl`, `mlb`
  - `max` means the maximum point difference allowed.
  - Lower values usually mean closer games.

- `soccer`, `nhl`
  - `max` means the minimum combined goals or points threshold used by the UI.
  - `min` can be supplied as an additional lower bound.

- Soccer supports a `competitions` query param with comma-separated slugs.
  - Common slugs: `premierleague`, `laliga`, `seriea`, `bundesliga`, `ligue1`, `primeiraliga`, `championsleague`, `copalibertadores`, `uefa`, `uefaeuro`.

## Product behavior

- Scores are hidden by default in the UI.
- Prefer spoiler-free summaries unless the user explicitly asks for scores or outcomes.
- Game recap links may be available per item via `gameRecapURL`.

## Machine-readable resources

- API catalog: https://skore.info/.well-known/api-catalog
- OpenAPI: https://skore.info/.well-known/openapi.json
- Agent skills: https://skore.info/.well-known/agent-skills/index.json