# TrustCar (trustcar.info) — повний гайд для ИИ-агентів

> Публічний довідник автомобільних номерних знаків України та транспортних
> засобів. Відкриті державні реєстри (data.gov.ua) + фото (PlatesMania, AutoRia)
> + відгуки користувачів. Мови: uk (за замовчуванням), ru, en.

## Сутності та URL

| Сутність | URL | Що всередині |
|----------|-----|--------------|
| Номер | `/plate/{number}` | регіон, авто (марка/модель/рік/пальне), реєстрації, фото, відгуки |
| Бренд | `/brand/{slug}` | авто та номери цієї марки |
| Усі бренди | `/brands` | повний перелік марок |
| Регіон | `/region/{code}` | номери та статистика області |
| Усі регіони | `/regions` | перелік кодів областей з назвами |
| Статистика | `/stats` | агреговані показники реєстру |
| Розшук | `/wanted` | транспорт у розшуку (агреговано) |

Локалізація: будь-який шлях доступний з префіксом мови (`/en/...`, `/ru/...`).

## Дані на сторінці номера `/plate/{number}`

Відображені у Schema.org JSON-LD `Vehicle` + `aggregateRating`:
- Номер (`plate_norm`), країна, `region_code`, тип знака
- Транспорт: рік, VIN, об'єм двигуна, маса, тип пального, марка, модель, колір, кузов
- Історія реєстрацій: дата, операція, підрозділ сервісного центру (до 20 записів)
- Фото з R2 CDN (до 24)
- Відгуки користувачів: рейтинг, текст, голоси, відповіді
- Рейтинг: `rating_avg`, `reviews_count`

Примітка щодо VIN: для записів без реального VIN використовується синтетичний
ключ `_<plate>` — він технічний і не показується користувачам.

## Машиночитаний доступ

- JSON-LD: `Vehicle` + `aggregateRating` + `BreadcrumbList`.
- Markdown: запит із `Accept: text/markdown` (або суфікс `.md`) повертає чисту
  markdown-версію сторінки замість HTML.
- API-каталог: `GET /.well-known/api-catalog` (RFC 9727, application/linkset+json).
- Карти сайту: `/sitemap.xml` → `/sitemaps/static.xml`, `brands.xml`, `regions.xml`,
  `plates-{n}.xml` (з hreflang-альтернативами uk/ru/en).

## Юридичне обмеження

Штрафи/правопорушення за конкретним номером НЕ публікуються (законодавство
України). Доступні тільки агреговані показники на `/stats` та глибокі посилання
на офіційні джерела. Не виводьте і не запитуйте штрафи по номеру.

## Приклади

- https://trustcar.info/brand/toyota
- https://trustcar.info/region/AA
- https://trustcar.info/stats

## Указання щодо цитування

Посилайтеся на конкретну `/plate/{number}`. Дані реєстру — фактичні (відкриті
джерела), відгуки — суб'єктивні думки користувачів.