Добавить организацию в граф за 1 день

Пошаговая инструкция по добавлению вашей организации в реестр Граф филармоний

Для кого эта инструкция:

Настоящий раздел содержит техническую документацию, предназначенную для специалистов в области информационных технологий: ИТ-специалистов филармоний, веб-разработчиков и всех, кто хочет добавить свою филармонию в единый реестр Граф филармоний.

Требования: Доступ к файлам сайта или возможность редактировать HTML-код страниц.

Шаг 1. Верификация домена

Перед добавлением организации в реестр необходимо подтвердить владение вашим доменом.

1.1. Откройте генератор профилей

Перейдите на страницу: Генератор организаций

1.2. Запросите код верификации

  1. Введите адрес вашего сайта (например: https://filarmonia.online)
  2. Нажмите кнопку "Запросить код верификации"
  3. Система проверит статус вашей организации:
    • Организация уже существует + код найден на сайте → форма откроется сразу ✅
    • Организация существует + код НЕ найден → система покажет ваш код ⚠️
    • Новая организация → будет выдан новый код 🆕

1.3. Разместите код верификации

Выберите удобный способ:

Способ А: Файл (рекомендуется)

  1. Создайте файл id-filarmonia-verify.txt
  2. Разместите в корне сайта
  3. Вставьте код верификации
  4. Проверьте: https://ваш-сайт.ru/id-filarmonia-verify.txt

Способ Б: Meta-тег

Добавьте в <head> главной страницы:

<meta name="id-filarmonia-verification" content="if-verify-abc123">

Важно: Не удаляйте код верификации после проверки! Он нужен для будущих обновлений.

1.4. Проверьте верификацию

Нажмите "Проверить верификацию". При успехе откроется форма генератора.

Шаг 2. Заполните данные организации

После верификации откроется форма. Заполните информацию о вашей организации.

Обязательные поля

  • Название — Публичное название организации
  • URL сайта — Заполнится автоматически
  • Тип организации — Филармония

Рекомендуемые поля

  • @id — Уникальный идентификатор (рекомендуется: https://ваш-сайт.ru/id/organization.jsonld)
  • UUID — Постоянный идентификатор в формате UUID v4 (генерируется автоматически)
  • Slug — Человекопонятный идентификатор для поисковой оптимизации, SEO (например: permskaya-filarmonia)
  • Юридическое название
  • Описание
  • Логотип (URL)
  • Изображения (фасад, залы)
  • Ссылки на профили (VK, Telegram, Культура.РФ)
  • Дата основания
  • Адрес (улица, город, регион, индекс)
  • Телефон

🆕 Новое в версии 1.1:

  • Slug — создает удобные адреса страниц (например: /org/permskaya-filarmonia/)
  • UUID — теперь обязательное поле для всех сущностей
  • Возможность добавлять события (концерты, спектакли) — см. документацию Events
  • Возможность добавлять исполнителей (персоны, коллективы) — см. документацию Performers

Подробнее: Спецификация версии 1.1

Дополнительные блоки

Блок 2: Контакты

Добавьте контакты отделов:

  • Кнопка "Добавить контакт"
  • Тип, телефон, электронная почта, адрес страницы

Блок 3: Источники данных (Data Endpoints)

Укажите, какие данные вы планируете публиковать (все опционально):

  • health.jsonld — Статус и навигация API
  • places.jsonld — Залы и площадки
  • events.jsonld — Концерты и мероприятия
  • performers.jsonld — Исполнители и коллективы

Зачем это нужно? Блок links позволяет российским ИИ-агентам (Алиса, ГигаЧат и другим) автоматически находить все доступные данные вашей организации через навигацию по ссылкам (принцип HATEOAS). Прочитав organization.jsonld, ИИ узнает, где искать события, исполнителей и другую информацию.

Расширенные возможности версии 1.1

После добавления базовой информации вы можете расширить свой профиль:

События (концерты, спектакли)

Добавьте информацию о предстоящих и прошедших мероприятиях с полной информацией:

  • Название и описание события
  • Дата и время проведения
  • Место проведения (зал)
  • Исполнители (дирижер, солисты, коллективы)
  • Информация о билетах (цена, доступность)
  • Программа концерта (исполняемые произведения)

Подробная документация по событиям (Events) →

Исполнители (персоны и коллективы)

Создайте профили для артистов и музыкальных коллективов:

  • Персоны: дирижеры, солисты, композиторы с биографией и наградами
  • Коллективы: оркестры, хоры, ансамбли с историей и составом
  • Связь с событиями через поле performer

Подробная документация по исполнителям (Performers) →

Примечание: События и исполнители пока не поддерживаются в генераторе организаций. Для их добавления необходимо создавать JSON-LD (формат структурированных данных) вручную согласно документации или использовать программный интерфейс данных (Data Endpoint API).

Шаг 3. Выберите способ размещения JSON-LD

Система автоматически добавит вас в реестр. Осталось разместить JSON-LD профиль на вашем сайте.

Вариант А: Отдельный файл (рекомендуется)

Инструкция:

  1. Выберите "Вариант А" в генераторе
  2. Нажмите "Обновить профиль и данные в реестре"
  3. Скопируйте JSON-LD код
  4. Создайте папку /id/ на вашем сайте
  5. Сохраните код в файл /id/organization.jsonld
  6. Проверьте доступность: https://ваш-сайт.ru/id/organization.jsonld

Рекомендации для SEO:

Добавьте в <head> главной страницы:

<link rel="alternate" type="application/ld+json"
      href="https://ваш-сайт.ru/id/organization.jsonld">

Добавьте в sitemap.xml:

<url>
  <loc>https://ваш-сайт.ru/id/organization.jsonld</loc>
  <changefreq>monthly</changefreq>
</url>

Вариант Б: На странице сайта

Инструкция:

  1. Выберите "Вариант Б" в генераторе
  2. Укажите URL страницы (обычно главная или "О нас")
  3. Нажмите "Обновить профиль и данные в реестре"
  4. Скопируйте код (с тегом <script>)
  5. Вставьте в <head> или перед </body>

Пример:

<script type="application/ld+json">
{
  "@context": [
    "https://schema.org",
    "https://id.filarmonia.online/spec/1.1/context.jsonld"
  ],
  "@type": "Organization",
  "uuid": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
  "name": "Пермская краевая филармония",
  "url": "https://filarmonia.online",
  "links": [
    {"rel": "self", "href": "https://filarmonia.online/id/organization.jsonld"},
    {"rel": "spec", "href": "https://id.filarmonia.online/spec/1.1/"},
    {"rel": "events", "href": "https://filarmonia.online/id/events.jsonld"},
    {"rel": "performers", "href": "https://filarmonia.online/id/performers.jsonld"}
  ],
  ...
}
</script>

Для CMS:

  • WordPress: Файл header.php или плагин для <head>
  • Joomla: Шаблон сайта или менеджер плагинов
  • Bitrix: /local/templates/your_template/header.php
  • Drupal: Модуль Metatag или html.html.twig

Шаг 4. Дождитесь модерации

После отправки вы увидите сообщение "⏳ Ожидает модерации".

Что происходит:

  1. Ваши данные отправлены администратору на проверку
  2. Администратор проверит корректность данных (обычно до 1 рабочего дня)
  3. После активации:
    • Организация появится в реестре
    • Будет создана страница профиля
    • Данные войдут в граф организаций

Ваша страница профиля: https://id.filarmonia.online/org/ваш-slug/

Граф организаций: https://id.filarmonia.online/graph/organizations.jsonld

Шаг 5. Проверьте в валидаторе

После размещения кода обязательно проверьте правильность разметки с помощью онлайн-валидатора JSON-LD — это единственный инструмент, который корректно обрабатывает расширенные контексты Граф филармоний.

Онлайн-валидатор JSON-LD

Рекомендуемый инструмент для проверки JSON-LD с поддержкой расширенных контекстов

Открыть валидатор

Что проверять:

  • Отсутствие синтаксических ошибок JSON
  • Корректность типов данных
  • Наличие обязательных полей (@id, @type, name, url)
  • Правильность URI-ссылок

Обновление данных

Для обновления информации об организации:

  1. Вернитесь на страницу генератора
  2. Введите URL вашего сайта
  3. Если код верификации остался на сайте → форма откроется с текущими данными
  4. Внесите изменения
  5. Нажмите "Обновить профиль и данные в реестре"
  6. Обновите JSON-LD файл/код на вашем сайте
  7. Изменения вступят в силу после модерации (если статус стал "pending_update")

Важно: Если код верификации остался на сайте, система автоматически распознает вас. Не нужно проходить верификацию заново!

Часто задаваемые вопросы

Можно ли удалить код верификации после первой проверки?

Нет! Код нужен для будущих обновлений. Оставьте его на сайте постоянно.

Что делать, если я потерял код верификации?

Введите URL вашего сайта в генератор - система покажет ваш текущий код.

Как долго проверяются данные?

Обычно до 1 рабочего дня.

Можно ли изменить способ размещения (файл → страница)?

Да, просто обновите данные через генератор и выберите новый способ.

Какую версию спецификации использовать?

Рекомендуем использовать версию 1.1 (/spec/1.1/context.jsonld) для всех новых проектов. Она включает поддержку событий, исполнителей и SEO-дружественных slug. Версия 1.0 остается доступной для обратной совместимости.

Что такое slug и нужен ли он?

Slug — это человекопонятный идентификатор для URL (например: permskaya-filarmonia). Он опциональный, но рекомендуется для улучшения SEO. UUID остается обязательным постоянным идентификатором.

Этапы внедрения стандарта

Внедрение Граф филармоний можно разделить на два этапа. Первый этап — обязательный для попадания в реестр. Второй — опциональный, для тех кто хочет расширить присутствие.

Этап 1 Базовый профиль

Что создаёт генератор

Полноценное решение для старта:

  • Профиль организации — название, контакты, адрес, описание
  • Место в реестре — видимость в едином каталоге

Что вы получаете

  • Филармония в централизованном реестре
  • Видимость в Яндексе
  • Данные для российских ИИ-ассистентов (Алиса, ГигаЧат)
  • Машиночитаемый профиль по Schema.org (международный словарь описания данных)

Этого достаточно для участия в реестре и базовой видимости в поисковиках.

Этап 2 Расширение (опционально)

Что можно добавить

Для тех, кто хочет большего:

  • События (Event) — афиша концертов и спектаклей
  • Артисты (Person) — солисты, дирижёры, музыканты
  • Коллективы (MusicGroup) — оркестры, ансамбли, хоры

Что это даёт

  • Афиша в результатах поиска
  • Ответы ИИ о расписании и репертуаре
  • Расширенные сниппеты в Яндексе

Требует интеграции с вашей системой управления сайтом (CMS) или базой данных.

Партнёрский интерфейс данных — полная спецификация источников данных. Проконсультируем по интеграции.

Поздравляем!

После выполнения всех шагов ваша организация станет частью единого графа культурных знаний России. Структурированные данные сделают вашу организацию видимой для:

  • Поисковых систем (Яндекс и другие)
  • Российских ИИ-ассистентов (Алиса, ГигаЧат)
  • Государственных информационных систем
  • Культурных агрегаторов и каталогов

Спасибо, что присоединились к Граф филармоний!