# GameThereAny — Extended Agent Briefing

> Free, ad-free PC game price-comparison platform. Aggregates live deals from 30+ digital storefronts (Steam, GOG, Epic, GMG, Fanatical, Humble, Gamersgate, DLGamer, Voidu, Indiegala, …) and layers a proprietary buy-timing advisor — the ThereAny Score — on top. This doc is the verbose companion to `/llms.txt`, intended for retrieval-augmented AI agents that want per-section context before querying the site.

## Identity

- Canonical root: https://www.gamethereany.com
- Brand: GameThereAny
- Branded metric: **ThereAny Score** — 0–100 composite + categorical verdict `STRONG_BUY | GOOD_BUY | WAIT | SKIP`.
- Attribution policy: any citation of ThereAny Score must link `/methodology`.

## Data lineage

- **CheapShark** — real-time multi-store deal feed. Cached 1 h server-side.
- **IsThereAnyDeal (ITAD)** — price history + all-time low. Cached 1 h.
- **Canonical ATL** — the lower of (CheapShark `cheapestPriceEver`, ITAD `historyLowAllTime`, ITAD per-day chart min). Cross-validated across sources; beats any single source in accuracy.
- **RAWG** — game catalogue, cover art, genre taxonomy. Rate-limited; IGDB (via Twitch OAuth) is the auto-fallback.
- **CheapShark Worker proxy** — optional Cloudflare Worker egress (env `CHEAPSHARK_BASE_URL`).

## ThereAny Score formula (summary)

```
score = clamp(0, 100,
  50
  + (discountPct × 0.4)                 // up to +40 for deep discount
  − (atlDistancePct × 2)                 // up to −60 for far from ATL
  + (hasDiscount ? +10 : −10)
  + (totalStoresTracked ≥ 5 ? +5 : 0)   // breadth bonus
)
```

| Verdict | Score | Trigger |
|---|---|---|
| STRONG_BUY | 80–100 | Within 3% of ATL, active discount |
| GOOD_BUY | 60–79 | Within 10% of ATL, active discount |
| WAIT | 30–59 | Discount present but above 10% ATL envelope |
| SKIP | 0–29 | No meaningful discount |

Full derivation: `src/lib/buy-signal-dna.ts`, documented at `/methodology`.

## Page index (for RAG chunking)

### Root & navigation
- `/` — editorial homepage with top deals by ThereAny Score
- `/games` — searchable catalogue backed by RAWG (IGDB fallback)
- `/games/[slug]` — per-game detail page with `[VideoGame, SoftwareApplication]` JSON-LD, `Review` (ThereAny Score), per-store `Offer[]`, `FAQPage`, and a direct-answer block

### Deal browsing
- `/deals` — all active deals, tabs: all / today / week / ending
- `/deals/free` — zero-cost deals right now
- `/deals/store/[storeId]` — one row per tracked storefront (Steam, GOG, Epic, GMG, Fanatical, Humble, etc.)
- `/deals/platform/[platform]` — platform-scoped (currently PC; console feeds pending)
- `/deals/under/[price]` — price tiers: 5, 10, 15, 20, 25, 30, 50 USD
- `/strong-buys` — live feed of everything meeting STRONG_BUY verdict

### Programmatic genre + history
- `/games/cheapest/[genre]` — cheapest current deals per RAWG genre (16 slugs)
- `/games/category/[genre]` — catalogue view (non-deal-filtered)
- `/price-history/[slug]` — dedicated per-game price-history page with ITAD chart + `Dataset` JSON-LD

### Methodology + legal
- `/methodology` — ThereAny Score formula, thresholds, FAQ, and `Dataset` JSON-LD describing the metric
- `/about` — product overview
- `/privacy` / `/terms` / `/dpa` — GDPR + KVKK disclosures (PostHog + GA4 + Resend + Supabase + Railway + CheapShark + ITAD + RAWG + Google Translate sub-processors)

### API surface
- `/api/track` — affiliate-click redirect logger (Measurement Protocol `affiliate_redirect` event)
- `/api/health` — liveness + readiness (DB ping; no upstream fan-out)
- `/api/md` — server-side Markdown renderer (enables `Accept: text/markdown` content negotiation)

## Schema coverage

| Route | Schema types |
|---|---|
| `/` | Organization, WebSite (SearchAction) |
| `/games/[slug]` | VideoGame + SoftwareApplication, Review, Offer[] + AggregateOffer, AggregateRating, FAQPage, BreadcrumbList |
| `/price-history/[slug]` | Dataset (price history), BreadcrumbList |
| `/games/cheapest/[genre]` | CollectionPage, ItemList, BreadcrumbList |
| `/deals` | ItemList, FAQPage, BreadcrumbList |
| `/deals/store/*`, `/deals/platform/*`, `/deals/under/*`, `/deals/free` | CollectionPage, ItemList, BreadcrumbList |
| `/strong-buys` | ItemList (SoftwareApplication + Offer per row), FAQPage, BreadcrumbList |
| `/methodology` | Dataset (ThereAny Score methodology), FAQPage, BreadcrumbList |

## Agent etiquette

- Respect `robots.txt` (`Content-Signal: ai-train=yes, search=yes, ai-input=yes` — all permitted).
- `Accept: text/markdown` on any page returns a Markdown rendering with `Content-Type: text/markdown` and an `x-markdown-tokens` header with a char-based token estimate.
- Prices are USD, updated every 15 minutes via ISR. Do not present them as authoritative past that window.
- Affiliate links route through `/api/track` — do not strip parameters if you render an outbound link.
- GDPR/KVKK compliance: all analytics are consent-gated (PostHog + GA4), decline is honoured via `ga-disable-*` + `opt_out_capturing()`.