#2146: Настройка SEO-полей статьи (Open Graph, JSON-LD)
Отредактирована: сегодняКаждая статья базы знаний Swarmica содержит набор SEO-полей. Они помогают поисковым системам (Google, Яндекс), ответным системам (AEO) и генеративным ИИ-сервисам (GEO) — ChatGPT, Perplexity, YandexGPT и другим — правильно понять, о чём статья, и показать её пользователю.
Где находятся SEO-поля
SEO-поля находятся на вкладке SEO в редакторе статьи. Поля заполняются отдельно для каждого языка статьи.
Данные выводятся в <head> страниц публичного портала базы знаний (хелпцентра). Это работает только для опубликованных статей с доступом Все. Подробнее о хелпцентре — в статье Конфигурация SEO-оптимизированного публичного портала базы знаний.
Поля jsonld и html_head доступны начиная с версии Swarmica v6.1.0.
Описание полей
| Поле | Что выводится на странице | Рекомендации |
|---|---|---|
seo_title | og:title, twitter:title, share:title — заголовок в превью ссылок в соцсетях и мессенджерах | До 70 символов. Сформулируйте вопрос или проблему, которую решает статья. Не добавляйте название сайта. |
seo_description | description, og:description, twitter:description | Одно-два предложения до 160 символов: что статья помогает сделать и для кого. Без списков, кавычек и Markdown. |
seo_url | og:url | Относительный адрес статьи на этом языке, например /article/ru/205-создание-и-редактирование-статьи.html. |
seo_image | og:image, twitter:image и twitter:card с большим превью | Относительный путь к изображению, загруженному в статью, например /attachments/.... |
seo_keywords | keywords | От 3 до 7 слов и коротких фраз через запятую, по которым читатель будет искать статью. |
seo_type | og:type | Для статей базы знаний — article. |
seo_locale | og:locale | Язык в формате язык_РЕГИОН: ru_RU, en_US. |
jsonld | <script type="application/ld+json"> | Разметка Schema.org в формате JSON-LD без обёртки <script>. Подробнее — в статье Настройка разметки Schema.org. |
html_head | Вставляется в <head> страницы без изменений | Только для опытных пользователей, см. ниже. |
Если поле пустое, соответствующий тег на страницу не выводится.
Поле html_head
Содержимое поля html_head вставляется в <head> страницы статьи как есть, без проверки. Используйте только теги, допустимые внутри <head>: <meta>, <link>, <script>. Например:
<meta name="robots" content="noindex">
Этот тег запрещает поисковым системам индексировать конкретную статью, при этом она остаётся доступной всем пользователям.
Ошибка в разметке поля html_head может нарушить отображение страницы. После изменения поля откройте статью в хелпцентре и проверьте, что она отображается корректно.
Что Swarmica добавляет автоматически
Помимо SEO-полей, хелпцентр автоматически публикует данные для поисковых систем и LLM:
- На каждой странице статьи есть ссылка
<link rel="alternate" type="text/markdown">на Markdown-версию статьи. Её удобно читать языковым моделям. - Файлы
/llms.txtи/llms-full.txtсо списком и текстами публичных статей — см. Включение индексации публичного портала базы знаний для LLM (llms.txt). - Карта сайта
/robots/sitemap.xmlи файлrobots.txt— см. Карта сайта sitemap.xml и robots.txt публичной базы знаний.
Рекомендации по оформлению текста статьи
Поисковые системы и ИИ-сервисы оценивают не только SEO-поля, но и структуру самой статьи.
- Не используйте в тексте статьи заголовки первого уровня (
#). Заголовок статьи на странице хелпцентра выводится как<h1>, а в документе должен быть только один заголовок<h1>. Начинайте структуру текста с заголовков второго уровня (##); вложенные заголовки третьего и следующих уровней (###,####) использовать можно. Если шаблоны статей содержат заголовки первого уровня, замените их на##— см. Создание своих шаблонов статей. - Формулируйте заголовок статьи как вопрос или проблему — так, как её сформулировал бы пользователь.
- Давайте прямой ответ в начале решения. Если статья построена по структуре KCS, сформулируйте краткий прямой ответ в первом абзаце раздела Решение, а подробности приведите ниже. Если такого раздела нет, дайте прямой ответ в первом абзаце статьи. Ответные системы и LLM чаще цитируют короткий ответ, за которым следуют подробности.
- Одна статья — одна проблема. Несколько несвязанных тем в одной статье ухудшают её ранжирование.
- Структурируйте текст: нумерованные шаги, таблицы, блоки кода для команд и конфигураций.
- Не размещайте служебную информацию в публичном тексте. Для сотрудников используйте внутреннюю часть статьи — она не выводится в хелпцентре и в SEO-поля не попадает.
Автоматическое заполнение и контроль
SEO-поля можно заполнять автоматически с помощью ИИ-агента — см. Использование ИИ-агентов для SEO/GEO/AEO-оптимизации базы знаний.
При проверке качества контента (AQI) рекомендуется также проверять заполненность и корректность SEO-полей.