# Trace Logo's

> Бесплатный каталог SVG и PNG логотипов российских и международных брендов.

## Точка входа для AI-агентов

### Логотипы (288 брендов, ещё 152 запланированы — итого 440+)

**Индекс категорий (6 КБ):**
https://trace-logos.ru/logos-index.json

**Логотипы категории (1–8 КБ):**
https://trace-logos.ru/logos/{slug}.json

Примеры: `/logos/ai.json` · `/logos/bank.json` · `/logos/social.json`

**Полный индекс (113 КБ, может обрезаться):**
https://trace-logos.ru/logos.json

---

### Эмодзи (1918 штук, Apple + Google + Microsoft)

**Индекс категорий (1.7 КБ):**
https://trace-logos.ru/emoji-index.json

**Эмодзи категории:**
https://trace-logos.ru/emoji/{slug}.json

Доступные slug: `smileys` · `people` · `animals` · `food` · `travel` · `activities` · `objects` · `symbols` · `flags`

Примеры: `/emoji/smileys.json` · `/emoji/flags.json`

Поля каждого эмодзи:
- `name` — русское название ("Широко улыбается")
- `emoji` — символ ("😀")
- `figma` — путь компонента ("Emoji/GrinningFace")
- `appleUrl` — URL PNG Apple (160×160px)
- `googleUrl` — URL PNG Google (или null)
- `microsoftUrl` — URL SVG Microsoft Fluent Emoji (или null); 1525 из 1918 эмодзи имеют Microsoft-вариант

В `emoji.json` у каждого эмодзи также есть поле `url` — ссылка на HTML-страницу эмодзи.

---

### HTML-страницы (для людей и краулеров)

- **Страница логотипа:** `/logos/{category}/{slug}/` — превью, скачивание SVG/PNG, цвета бренда (hex), FAQ
- **Страница эмодзи:** `/emoji/{category}/{slug}/` — символ, Юникод, варианты Apple/Google/Microsoft, FAQ (например `/emoji/smileys/grinning-face/`)
- **Категория эмодзи:** `/emoji/{slug}/` — сетка всех эмодзи категории
- **Подборки:** `/collections/{slug}/` — кросс-категорийные наборы (`russian-banks`, `neural-networks`, `marketplaces`, `payment-systems`, `messengers-social`, `delivery-taxi`)
- **Блог:** `/blog/` — статьи о логотипах, форматах и эмодзи
- **Карта сайта:** `/sitemap.xml` (индекс) → `/sitemap-pages.xml`, `/sitemap-logos.xml`, `/sitemap-emoji.xml`

---

## Структура данных

### logos.json — полный индекс

```
GET https://trace-logos.ru/logos.json
```

Поля каждого объекта в массиве `logos[]`:

| Поле          | Тип            | Описание                                              |
|---------------|----------------|-------------------------------------------------------|
| name          | string         | Русское название бренда ("Сбер", "Т-Банк")           |
| category      | string         | Категория ("Банки", "Социальные сети")                |
| categorySlug  | string         | Слаг категории ("bank", "social")                     |
| url           | string         | URL страницы логотипа (статический HTML)              |
| svgUrl        | string \| null | Прямой URL SVG-файла (null если только PNG)           |
| pngUrl        | string \| null | Прямой URL PNG-файла. null = PNG генерируется динамически из SVG на клиенте (нет статического файла) |
| ecosystem     | string \| null | Экосистема ("yandex", "sber", "tinkoff", null)        |
| formats       | string[]       | Доступные форматы: ["svg", "png"] или ["png"]         |
| comingSoon    | true \| absent | Логотип в разработке, файлы ещё не доступны           |

Пример — логотип с готовым PNG:
```json
{
  "name": "Т-Банк",
  "categorySlug": "bank",
  "url": "/logos/bank/tbank/",
  "svgUrl": "/assets/logos/svgs/t-bank.svg",
  "pngUrl": "/assets/logos/pngs/t-bank.png",
  "ecosystem": "tinkoff",
  "formats": ["svg", "png"]
}
```

Пример — логотип только с SVG (PNG генерируется динамически, pngUrl = null):
```json
{
  "name": "Сбер",
  "categorySlug": "bank",
  "url": "/logos/bank/sber/",
  "svgUrl": "/assets/logos/svgs/sber.svg",
  "pngUrl": null,
  "ecosystem": "sber",
  "formats": ["svg", "png"]
}
```

Пример — запланированный логотип (comingSoon):
```json
{
  "name": "GigaChat",
  "categorySlug": "ai",
  "url": "/logos/ai/gigachat/",
  "svgUrl": null,
  "pngUrl": null,
  "comingSoon": true
}
```

---

### manifest.json — список категорий

```
GET https://trace-logos.ru/logos/manifest.json
```

```json
{
  "categories": [
    { "section": "Банки", "file": "categories/banki.json", "slug": "bank" },
    { "section": "Социальные сети", "file": "categories/messendzhery-i-socseti.json", "slug": "social" }
  ]
}
```

### Данные категории

```
GET https://trace-logos.ru/logos/categories/{filename}.json
```

Пример: https://trace-logos.ru/logos/categories/banki.json

```json
{
  "section": "Банки",
  "items": [
    {
      "name": "Сбер",
      "tags": "сбер сбербанк sber sberbank",
      "figma": "Icon/Bank/Sber",
      "file": "sber.svg",
      "ecosystem": "sber",
      "variants": [
        { "type": "full", "file": "sber-full.svg" }
      ]
    }
  ]
}
```

Поля item:

| Поле       | Описание                                                    |
|------------|-------------------------------------------------------------|
| name       | Название бренда                                             |
| tags       | Ключевые слова для поиска (RU + EN)                        |
| figma      | Путь компонента в Figma ("Icon/Bank/Sber")                 |
| file       | Имя файла в assets/logos/svgs/ или assets/logos/pngs/      |
| ecosystem  | Группа брендов (опционально)                               |
| variants   | Дополнительные варианты логотипа (опционально)             |
| comingSoon | true — логотип в разработке, файла нет                     |

Типы вариантов: `svg`, `png`, `full` (горизонтальный), `full_en` (горизонтальный EN)

---

## Как получить файл логотипа

SVG:
```
https://trace-logos.ru/assets/logos/svgs/{file}
```

PNG:
```
https://trace-logos.ru/assets/logos/pngs/{file}
```

---

## URL паттерны страниц

Страница логотипа (статический HTML, без JS):
```
/logos/{categorySlug}/{logoSlug}/
```
Пример: https://trace-logos.ru/logos/bank/sber/

Страница категории:
```
/logos/{categorySlug}/
```
Пример: https://trace-logos.ru/logos/bank/

---

## Типичные сценарии

**Найти логотип Сбера:**
1. GET logos.json → найти запись где `name === "Сбер"`
2. Взять `svgUrl` → скачать SVG

**Получить все логотипы экосистемы Яндекс:**
1. GET logos.json → фильтровать где `ecosystem === "yandex"`

**Получить все банки:**
1. GET logos.json → фильтровать где `categorySlug === "bank"`
   или GET logos/categories/banki.json

**Найти логотип по названию:**
1. GET logos.json → искать в поле `name` или в `tags` через category JSON

---

## Категории (35 штук)

bank, payment, social, video, music, messenger, map, search, ai, cloud,
mail, office, system, macos, design, web, dev, videocall, market, food,
delivery, store, reviews, ads, assistant, telecom, travel, education,
health, insurance, crm, docs, hr, flag, b2b, bnpl, car

---

## Экосистемы

yandex, sber, vk, tinkoff, ozon, meta, google, apple, microsoft,
alfa, mts, avito, wildberries, x5, nspk, kontur, openai, bytedance,
adobe, valve, mvideo, sovcombank

---

## Дополнительные разделы

### Figma-плагин

Официальный плагин Trace Logos для Figma позволяет вставлять логотипы и эмодзи прямо на холст — без скачивания файлов.

- **Figma Community:** https://www.figma.com/community/plugin/1643124536537861799/trace-logos
- Поиск по 288 логотипам и 1918 эмодзи внутри Figma
- Вставка как векторных слоёв (SVG → Figma-ноды)
- Редактор цвета и выбор вариантов внутри плагина
- Бесплатно, без регистрации

### Блог
`/blog/` — статьи о логотипах, SVG/PNG, эмодзи и брендах. Каждая статья: `/blog/{slug}/`.

### Подборки
`/collections/{slug}/` — кросс-категорийные наборы логотипов.

Доступные подборки: `russian-banks`, `neural-networks`, `marketplaces`, `payment-systems`, `messengers-social`, `delivery-taxi`.

### Статические страницы эмодзи
Каждый эмодзи имеет HTML-страницу по паттерну:
```
/emoji/{categorySlug}/{emojiSlug}/
```
Пример: `/emoji/smileys/grinning-face/`

Содержимое: символ, юникод-кодпоинт, варианты Apple/Google, FAQ.

Поле `url` в `emoji.json` содержит корневой путь к этой странице (`/emoji/smileys/grinning-face/`).

### Карта сайта
- `/sitemap.xml` — индекс
- `/sitemap-pages.xml` — статические страницы
- `/sitemap-logos.xml` — все страницы логотипов
- `/sitemap-emoji.xml` — все страницы эмодзи

---

## Авторские права

Логотипы принадлежат их правообладателям. По вопросам удаления: @mansurov_rafael (Telegram).