# Настройка SEO-полей статьи (Open Graph, JSON-LD)
Каждая статья базы знаний Swarmica содержит набор SEO-полей. Они помогают поисковым системам (Google, Яндекс), ответным системам (AEO) и генеративным ИИ-сервисам (GEO) — ChatGPT, Perplexity, YandexGPT и другим — правильно понять, о чём статья, и показать её пользователю.

## Где находятся SEO-поля

SEO-поля находятся на вкладке **SEO** в редакторе статьи. Поля заполняются отдельно для каждого языка статьи.

Данные выводятся в `<head>` страниц публичного портала базы знаний (хелпцентра). Это работает только для опубликованных статей с доступом **Все**. Подробнее о хелпцентре — в статье [Конфигурация SEO-оптимизированного публичного портала базы знаний](https://support.swarmica.com/article/ru/1040).

:::tip
Поля `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](https://support.swarmica.com/article/ru/2147). |
| `html_head` | Вставляется в `<head>` страницы без изменений | Только для опытных пользователей, см. ниже. |

Если поле пустое, соответствующий тег на страницу не выводится.

## Поле html_head

Содержимое поля `html_head` вставляется в `<head>` страницы статьи как есть, без проверки. Используйте только теги, допустимые внутри `<head>`: `<meta>`, `<link>`, `<script>`. Например:

```html
<meta name="robots" content="noindex">
```

Этот тег запрещает поисковым системам индексировать конкретную статью, при этом она остаётся доступной всем пользователям.

:::caution
Ошибка в разметке поля `html_head` может нарушить отображение страницы. После изменения поля откройте статью в хелпцентре и проверьте, что она отображается корректно.
:::

## Что Swarmica добавляет автоматически

Помимо SEO-полей, хелпцентр автоматически публикует данные для поисковых систем и LLM:

*   На каждой странице статьи есть ссылка `<link rel="alternate" type="text/markdown">` на Markdown-версию статьи. Её удобно читать языковым моделям.
*   Файлы `/llms.txt` и `/llms-full.txt` со списком и текстами публичных статей — см. [Включение индексации публичного портала базы знаний для LLM (llms.txt)](https://support.swarmica.com/article/ru/1483).
*   Карта сайта `/robots/sitemap.xml` и файл `robots.txt` — см. [Карта сайта sitemap.xml и robots.txt публичной базы знаний](https://support.swarmica.com/article/ru/2149).

## Рекомендации по оформлению текста статьи

Поисковые системы и ИИ-сервисы оценивают не только SEO-поля, но и структуру самой статьи.

*   **Не используйте в тексте статьи заголовки первого уровня (`#`).** Заголовок статьи на странице хелпцентра выводится как `<h1>`, а в документе должен быть только один заголовок `<h1>`. Начинайте структуру текста с заголовков второго уровня (`##`); вложенные заголовки третьего и следующих уровней (`###`, `####`) использовать можно. Если шаблоны статей содержат заголовки первого уровня, замените их на `##` — см. [Создание своих шаблонов статей](https://support.swarmica.com/article/ru/522).
*   **Формулируйте заголовок статьи как вопрос или проблему** — так, как её сформулировал бы пользователь.
*   **Давайте прямой ответ в начале решения.** Если статья построена по структуре KCS, сформулируйте краткий прямой ответ в первом абзаце раздела **Решение**, а подробности приведите ниже. Если такого раздела нет, дайте прямой ответ в первом абзаце статьи. Ответные системы и LLM чаще цитируют короткий ответ, за которым следуют подробности.
*   **Одна статья — одна проблема.** Несколько несвязанных тем в одной статье ухудшают её ранжирование.
*   **Структурируйте текст**: нумерованные шаги, таблицы, блоки кода для команд и конфигураций.
*   **Не размещайте служебную информацию в публичном тексте.** Для сотрудников используйте внутреннюю часть статьи — она не выводится в хелпцентре и в SEO-поля не попадает.

## Автоматическое заполнение и контроль

SEO-поля можно заполнять автоматически с помощью ИИ-агента — см. [Использование ИИ-агентов для SEO/GEO/AEO-оптимизации базы знаний](https://support.swarmica.com/article/ru/2148).

При [проверке качества контента](https://support.swarmica.com/article/ru/214) (AQI) рекомендуется также проверять заполненность и корректность SEO-полей.

## Связанные статьи

*   [Настройка разметки Schema.org в статьях (JSON-LD, микроразметка)](https://support.swarmica.com/article/ru/2147)
*   [Использование ИИ-агентов для SEO/GEO/AEO-оптимизации базы знаний](https://support.swarmica.com/article/ru/2148)
*   [Карта сайта sitemap.xml и robots.txt публичной базы знаний](https://support.swarmica.com/article/ru/2149)
*   [Включение индексации публичного портала базы знаний для LLM (llms.txt)](https://support.swarmica.com/article/ru/1483)
*   [Создание и редактирование статьи](https://support.swarmica.com/article/ru/205)