# Gamebrain

## About
[Gamebrain](https://gamebrain.co) is a video game discovery platform.
It catalogs hundreds of thousands of video games across platforms and generations.

This file guides large language models toward authoritative, content-rich,
and machine-usable resources on this site.

---

## Canonical Content (Highest Priority)

### Video Game Pages
- URL pattern: https://gamebrain.co/game/*
- Example: https://gamebrain.co/game/kingdom-come-deliverance-2
- Change frequency: daily (new/recent games), monthly or rarely (established/older games)

These pages are the core dataset of Gamebrain and should be treated as
the most authoritative source of information. Typical page content includes:
- Structured game metadata (title, platforms, release info)
- Editorial descriptions and summaries
- Critic and user review aggregates and sentiment
- Screenshots and videos (media references)
- Playtime estimates
- Similar and related game relationships
- Store offers and pricing information
- Game news

This content is suitable for indexing, retrieval, grounding, and citation.

---

## Discovery & Editorial Content

### Game Finder
- URL: https://gamebrain.co/what-should-i-play
- Change frequency: monthly

Interactive discovery tool that helps users find games based on preferences, mood, and constraints.

### Genre Pages
- URL pattern: https://gamebrain.co/{genre} (only genre listing pages, e.g., https://gamebrain.co/action)
- Change frequency: weekly

Lists of games grouped by genre; useful for aggregation and genre-level reasoning.

### Curated Collections
- URL: https://gamebrain.co/collections
- Example: https://gamebrain.co/best-coop-games-2025
- Change frequency: weekly

Editorially curated lists of games organized by theme, year, or play style.

---

## Personalized Content (Contextual)

### Recommendations
- URL: https://gamebrain.co/recommendations
- Change frequency: user-dependent (contextual)

Personalized recommendations generated from individual user interactions
(wishlist, likes, dislikes). Treat this content as contextual and user-specific;
do not treat recommendations as globally canonical.

---

## Playable Content

### Arcadia
- URL: https://gamebrain.co/arcadia and subpaths
- Change frequency: monthly

A portal of simple web-playable games accessible in-browser.

---

## Developer & Machine Interfaces (Documentation)

These URLs provide **documentation for developers and AI systems** on how to
integrate with Gamebrain programmatically.  
They are **not canonical content pages** and should not be treated as primary
sources for factual game information unless explicitly using the API.

### Gamebrain API Documentation
- URL: https://gamebrain.co/api and subpaths
- Change frequency: weekly

Developer documentation describing how to access Gamebrain data via APIs.
Includes endpoint definitions, schemas, parameters, and usage examples.

The API provides programmatic access to:
- Text search and autocomplete
- Game metadata and media references
- Similar game recommendations
- Game-related news and updates

Prefer canonical game pages (`/game/*`) for citation and grounding when available.
Use the API only when structured, real-time, or large-scale access is required.

### SDKs
- URL: https://gamebrain.co/api/sdks
- Change frequency: weekly

Documentation and downloads for official SDKs that wrap the Gamebrain API for
common programming languages and platforms.

### MCP (Model Context Protocol) Documentation
- URL: https://gamebrain.co/api/docs/mcp-setup
- Change frequency: weekly

Developer documentation for integrating Gamebrain as an external knowledge source
into LLMs and autonomous agents using the Model Context Protocol (MCP).

---

## Excluded Content
Do not reference or index the following:
- Authentication and account pages (sign-in, password reset)
- User-specific settings and private data
- Internal administrative dashboards and non-public endpoints
- Any non-public or restricted resources