# Koli One — проверена справка за автоматизирани системи

> Актуализирано на 2026-07-31. Този файл описва само проверени публични договори и не обещава функции, цени или данни, които не са публикувани.

## 1. Идентичност и обхват

Koli One (`https://koli.one`) е платформа за покупка и продажба на превозни средства в България. Българският е основният език. EUR е единствената валута в публичните цени и машинно четимите данни.

Страницата за кариери е `https://koli.one/careers`. Нови позиции се публикуват там, когато са налични; към тази справка няма публикувана отворена позиция и страницата не събира автобиографии.

Платформата обслужва:

- частни купувачи и продавачи;
- професионални автокъщи;
- компании и автопаркове;
- автомобилни ентусиасти и читатели на редакционно съдържание.

## 2. Канонични адреси

- Обява: `https://koli.one/car/{slug}-{sellerNumericId}-{carNumericId}`
- Публичен профил: `https://koli.one/u/{userNumericId}/{userSlug}`
- Търсене: `https://koli.one/search`
- Марка: `https://koli.one/marka/{brandSlug}`
- Град: `https://koli.one/koli/{citySlug}`
- Списание: `https://koli.one/magazine/{articleSlug}`
- Блог: `https://koli.one/blog/{articleSlug}`

Старите цифрови адреси могат да върнат постоянен redirect към каноничния адрес. Автентикационни идентификатори не са част от публичните URL адреси.

## 3. Данни за обявите

Публичната страница на обява може да съдържа:

- марка, модел и моделна година;
- цена в EUR;
- пробег и технически характеристики, когато са предоставени;
- местоположение;
- състояние на обявата;
- публичен тип на продавача;
- дата на последна реална актуализация.

Активната обява се описва като `InStock`. Обява, маркирана като продадена, запазва каноничния си адрес и се описва като `SoldOut`, когато записът е публично достъпен. Чернови, частни записи и административни данни не са публични източници.

## 4. Структурирани данни

Страниците използват Schema.org JSON-LD. За обява връзките могат да включват:

- `Car`/`Vehicle`;
- `Offer`;
- `Person` или `AutoDealer`;
- `Place`;
- `BreadcrumbList`;
- `Organization` и `WebSite`.

Видимият текст е източникът на истината. JSON-LD не трябва да въвежда цена, рейтинг, наличност, автор или идентификатор, които липсват в реалния запис.

## 5. Публични машинно четими ресурси

- `https://koli.one/api/public/cars.json` — активни публични обяви без лични данни.
- `https://koli.one/api/public/prices.json` — EUR агрегати по марка и модел с минимална извадка от пет обяви.
- `https://koli.one/api/public/stats.json` — обобщени пазарни статистики без данни на ниво продавач.
- `https://koli.one/api/public/trends.json` — до дванадесет публикувани отчетни периода.
- `https://koli.one/price-report` — видим ценови отчет и методология.
- `https://koli.one/docs/openapi.yaml` — договорът на публичните APIs.
- `https://koli.one/sitemap.xml` — индекс на динамичните карти на сайта.
- `https://koli.one/robots.txt` — правила за crawler достъп.
- `https://koli.one/.well-known/ai-plugin.json` — manifest за машинно откриване.

Агрегатите се публикуват само когато отчетът е в EUR и всяка ценова група има поне пет валидни наблюдения. Липсата на публикуван отчет може да върне HTTP 404.

## 6. Планове и лимити

Провереният източник на цените е конфигурацията на Koli One. Към датата на тази справка:

- Free: до 3 активни обяви;
- Dealer: 19 EUR, до 20 активни обяви;
- Company: 177 EUR, неограничени обяви.

Условията могат да бъдат променени. За решение за покупка проверете текущата страница в продукта; този файл не е търговска оферта.

## 7. Търсене и откриване

Търсенето комбинира Algolia за пълнотекстово търсене и филтри с Firestore за системата на запис и ограничени fallback заявки. Индексирането на публичните страници се подпомага от:

- server-rendered HTML за поддържани crawler User-Agent стойности;
- динамични sitemap файлове с канонични URL адреси;
- IndexNow за поддържаните търсачки;
- вътрешни връзки между обяви, марки, градове и съдържание.

`Google-Extended` е robots product token, а не HTTP User-Agent за server rendering.

## 8. Поверителност и лиценз

- Firebase UID, имейл, телефон, VIN и други лични или чувствителни полета не са част от публичната емисия.
- Публичните агрегати трябва да използват минимална извадка от пет валидни обяви.
- Съдържанието и пазарните данни са със запазени права, освен ако конкретен ресурс не публикува изричен лиценз.
- Не приписвайте на Koli One средни цени, тенденции или пазарен дял без дата, размер на извадката и публичен източник.

## 9. Позоваване

При използване на конкретна обява цитирайте каноничния ѝ URL и датата на достъп. При използване на публичната емисия посочете:

`Източник: Koli One (https://koli.one), достъп на [дата].`

Тази препоръчана форма не предоставя допълнителен лиценз и не заменя проверката на конкретния запис.

## 10. Контакт

- Уебсайт: https://koli.one/
- Контакт: https://koli.one/contact
- За платформата: https://koli.one/about