# XTrust — довідник компаній України (повний гайд для ІІ-агентів)

XTrust (https://xtrust.info) — це довідник компаній та місць України з
перехресною перевіркою довіри. Для кожної компанії ми зводимо в один профіль:
репутацію її телефону (з KtoZvonil), довіру до її сайту (з Truster), офіційну
юридичну особу (з ЄДР), а також відгуки й рейтинги користувачів.

Мова контенту: українська. Покриття: ~304 000 компаній і місць по всій Україні.

## Що можна дізнатися про компанію
- Назва, категорія, місто, адреса, телефон, сайт, координати (мапа).
- Репутація номера телефону — скільки скарг/відгуків на KtoZvonil.
- Довіра до сайту — Safety-оцінка Truster (0–100).
- Юридична особа — ЄДРПОУ, організаційно-правова форма, статус реєстрації,
  керівник (зіставлено за назвою з відкритого реєстру ЄДР).
- Відгуки та зіркові рейтинги користувачів, відповіді власника.

## Структура URL
- `https://xtrust.info/` — головна + пошук.
- `https://xtrust.info/biz/{slug}` — профіль компанії (напр. /biz/radisson-blu-hotel-kyiv-city-centre-5e9c5378).
- `https://xtrust.info/c/{category}` — компанії за категорією (restaurant, hotel, pharmacy, bank, ...). Пагінація `/c/{category}/page/{n}`.
- `https://xtrust.info/city/{city}` — компанії у місті (Cyrillic, напр. /city/Київ). Пагінація `/city/{city}/page/{n}`.
- `https://xtrust.info/catalog` — усі категорії та міста.
- `https://xtrust.info/search?q={query}` — розумний пошук (розпізнає назву, номер телефону або домен).
- Фільтри у списках: `?phone=1` `?site=1` `?reviews=1` `?verified=1`; сортування `?sort=rating|reviews|name`.

## Доступ до даних для агентів
### 1. Markdown content negotiation
Надішліть заголовок `Accept: text/markdown` на будь-яку сторінку компанії —
отримаєте компактну Markdown-версію (без HTML, ~на 80% менше токенів).
Приклад: `curl -H "Accept: text/markdown" https://xtrust.info/biz/{slug}`

### 2. MCP (Model Context Protocol)
Streamable-HTTP JSON-RPC 2.0 сервер: `https://xtrust.info/mcp` (read-only).
Server card: `https://xtrust.info/.well-known/mcp/server-card.json`
Інструменти:
- `lookup_company(slug|query)` — повний профіль компанії: контакти, рейтинг,
  репутація номера (KtoZvonil), довіра сайту (Truster), юр. особа (ЄДР).
- `search_companies(query, city?)` — пошук компаній за назвою; повертає
  список з рейтингом і посиланнями.

### 3. OpenAPI / JSON
- OpenAPI 3.1: `https://xtrust.info/.well-known/openapi.json`
- Автодоповнення компаній (JSON): `https://xtrust.info/actions/suggest?q={query}`
- API-каталог (RFC 9727): `https://xtrust.info/.well-known/api-catalog`

### 4. Schema.org JSON-LD
Кожна сторінка `/biz/{slug}` містить `LocalBusiness` + (за наявності відгуків)
`AggregateRating` та `BreadcrumbList`. Головна — `Organization` + `WebSite`.

## Мережа перевірки (пов'язані сайти)
- KtoZvonil (https://ktozvonil.net) — відгуки та репутація номерів телефонів.
- TrustCar (https://trustcar.info) — українські автомобільні номери.
- Truster (https://truster.info) — довіра та відгуки про сайти/домени.
Профіль компанії на XTrust перелінковано з відповідними сторінками цих сайтів.

## Джерела та ліцензії
- Overture Maps Places — назви, категорії, адреси, телефони, сайти (CDLA-Permissive 2.0).
- ЄДР (data.gov.ua, Мінюст) — юридичні особи (CC-BY 4.0). KVED/адреси у відкритому дампі відсутні.
- Відгуки та рейтинги — контент користувачів XTrust (думки користувачів).

## Примітки для агентів
- Дані про компанію агрегуються з відкритих джерел; юр. особа зіставлена за
  назвою — можливі неточності (перевіряйте ЄДРПОУ в офіційному реєстрі).
- Поважайте `Content-Signal` у /robots.txt (search=yes, ai-input=yes, ai-train=yes — дозволено все).
- Приватні дії (/admin, /add, /r/, /claim, /dashboard, /login) закриті для індексації.