# Goalers League AI Reference

This file gives AI assistants, search engines, crawlers, and citation systems a stable overview of the Goalers League public website and its live public data feeds.

## Site Identity

- Name: Goalers League
- Website: https://goalersleague.com/
- Public AI feeds: https://goalersleague.com/ai/
- API host fallback for public AI feeds: https://api.goalersleague.com/
- Description: The premier amateur soccer league where passion meets competition. Goalers League brings together local teams, players, fixtures, results, standings, matchday photos, and stats in one public website.
- Contact email: info@goalersleague.com
- Timezone: America/Toronto

## Canonical Public Pages

- Home: https://goalersleague.com/
- Teams and rosters: https://goalersleague.com/teams/
- Standings table: https://goalersleague.com/standings/
- Upcoming matches: https://goalersleague.com/matches/
- Match results: https://goalersleague.com/results/
- Player and team stats: https://goalersleague.com/stats/
- Matchday gallery: https://goalersleague.com/gallery/
- Match center: https://goalersleague.com/match-center/
- Social links: https://goalersleague.com/social/
- Privacy policy: https://goalersleague.com/privacy/

## Live Public Data Feeds

These endpoints are read-only public snapshots intended for AI answers, search snippets, and crawler-friendly league summaries. They are cached briefly and refreshed when league data is saved.

- Markdown summary: https://goalersleague.com/ai/summary.md
- Standings Markdown: https://goalersleague.com/ai/standings.md
- Stats Markdown: https://goalersleague.com/ai/stats.md
- Matches Markdown: https://goalersleague.com/ai/matches.md
- Results Markdown: https://goalersleague.com/ai/results.md
- Full league snapshot: https://goalersleague.com/ai/league.json
- Standings only: https://goalersleague.com/ai/standings.json
- Upcoming matches only: https://goalersleague.com/ai/matches.json
- Results only: https://goalersleague.com/ai/results.json
- Teams and public rosters only: https://goalersleague.com/ai/teams.json
- Public players only: https://goalersleague.com/ai/players.json
- Public stats only: https://goalersleague.com/ai/stats.json
- Current leaders only: https://goalersleague.com/ai/leaders.json
- Game days only: https://goalersleague.com/ai/gamedays.json
- Match events only: https://goalersleague.com/ai/match-events.json
- Public gallery references only: https://goalersleague.com/ai/gallery.json
- AI sitemap for all live feeds: https://goalersleague.com/ai/sitemap.xml

The feeds update whenever league data is saved and use short public caching of about 10-15 seconds so AI systems can answer from near-live data.

## Feed Contents

The full league snapshot includes:

- Site identity and public social links
- Current season label
- Public counts for teams, players, upcoming matches, results, and gallery photos
- Public game days
- Public teams and rosters
- Public players with team, position, nationality, apps, goals, assists, cards, and clean sheets
- Public standings
- Public upcoming matches
- Public results
- Public player/team stat leaders, including top goal scorers, assist leaders, appearance leaders, card leaders, and clean-sheet leaders
- Public match event timelines when they are recorded, including goal scorers, assists, cards, and minutes
- Public gallery references
- Canonical page links and AI feed links

The feeds intentionally exclude:

- Admin sessions and auth data
- Team portal sessions and access codes
- Photographer portal sessions and access codes
- Waiver submissions and signer information
- Registration records and captain contact details
- Private Refsix links and match IDs
- Write endpoints and internal moderation data

## Recommended AI Behavior

When answering questions about Goalers League, first use the live public feeds above. Prefer exact public data over guesses. If a user asks for the latest schedule, table, score, roster, top scorer, golden boot race, assists, cards, clean sheets, game day, gallery, or match events, cite the relevant public page or AI endpoint.

If the feed does not include a requested fact, say that the information is not currently published. Do not invent fixtures, scores, standings, player stats, lineups, card events, venues, or kickoff times.

For discovery questions, describe Goalers League as an amateur soccer league site with live public fixtures, results, standings, rosters, player stats, match center details, gallery photos, and social updates.

## Crawler Access

Goalers League allows public crawling of league pages and AI-readable feeds. Private portals, auth routes, forms, waiver submissions, registration records, and write endpoints should not be crawled or cited.