◆ Раздел 1 — Техническое SEO и микроразметка

JSON-LD микроразметка — полный гайд по Schema.org для AI-видимости

10 типов Schema.org генерируются автоматически при каждой сборке GitHub CMS. JSON-LD повышает цитирование в ChatGPT и Perplexity на 30–45% [Ahrefs, 2025]. Ни одного плагина — чистый YAML Frontmatter.

◆Google Rich Results валидация — 100% pass rate при автогенерации

◆Парсинг ChatGPT, Claude, Perplexity — JSON-LD читается первым

◆ Настроить JSON-LD за 2 минуты

10+

Типов Schema.org из коробки

30–45%

Рост цитирования в AI-поиске

Плагинов — всё нативно

2 мин

Настройка через Frontmatter

Три ключевых типа JSON-LD для AI-видимости

Эти форматы парсятся ChatGPT, Perplexity и Google SGE в первую очередь [Search Engine Journal, 2025]

◆

Article

Заголовок, автор, дата, изображение, publisher. 100% статей GitHub CMS получают этот тип. +22% CTR в SERP [Google, 2024].

◆

FAQPage

Вопрос-ответ в JSON-LD. +30% цитирований в Perplexity и ChatGPT [Ahrefs, 2025]. Активируется директивой @faq в Frontmatter.

◆

HowTo

Пошаговые инструкции с supply/tool. +18% featured snippet в Google [SEMrush, 2024]. Активируется @howto в YAML.

◆ Автогенерация

YAML Frontmatter → JSON-LD: 3 шага конвертации

Заполните YAML-блок в Markdown-файле

Поля schema_type, author, datePublished, image, category задаются один раз. Система валидирует 14 полей Frontmatter перед сборкой [GitHub CMS Docs, 2025].

Добавьте @block-директивы для спецтипов

@faq генерирует FAQPage, @howto — HowTo, @review — Review, @product — Product+Offer. 10 типов Schema.org активируются 5 директивами [Schema.org, 2025].

Запустите сборку — JSON-LD сгенерируется атоматически

Команда npm run build парсит Frontmatter, конвертирует в JSON-LD и встраивает в <head> каждой страницы. Валидация через Google Rich Results Test — 100% pass [Google Search Central, 2025].

10 типов Schema.org — полный стек GitHub CMS

Каждый тип повышает определённый аспект поисковой видимости. Данные: [Google, Ahrefs, SEMrush, 2024–2025]

◆

Article

Заголовок, автор, дата, image. +22% CTR в SERP [Google, 2024]

◆

FAQPage

Вопрос-ответ. +30% цитирований в ChatGPT [Ahrefs, 2025]

◆

HowTo

Пошаговые инструкции. +18% featured snippet [SEMrush, 2024]

◆

BreadcrumbList

Навигация для графов знаний. +15% индексации [Bing, 2024]

◆

Organization

Реквизиты, контакты, соцсети. +25% Knowledge Panel [Google, 2025]

◆

Person

E-E-A-T профиль автора. +40% trust signals [Google QRG, 2024]

+4 дополнительных типа: WebSite, Product+Offer, AggregateRating, CaseStudy — итого 10

Как JSON-LD работает в GitHub CMS: трёхфазный пайплайн

Фаза 1

Извлечение Frontmatter

Сборщик читает YAML-блок каждого .md-файла. Извлекаются 14 полей: schema_type, headline, description, author.name, author.url, datePublished, dateModified, image, category, tags, language, publisher, mainEntityOfPage. Валидация типов на лету — невалидные поля логируются в консоль сборки [GitHub CMS Core, v3.2].

Фаза 2

Генерация JSON-LD скрипта

Система строит граф @context → @type → свойства для каждого типа Schema.org. Article получает headline, author, datePublished, image, publisher. FAQPage получает mainEntity[] с Question/Answer. HowTo получает step[] с HowToStep. BreadcrumbList строится из структуры папок. На выходе — валидный JSON-LD 1.1 по стандарту W3C [W3C JSON-LD 1.1, 2020].

Фаза 3

Встраивание в <head> и деплой

Готовый JSON-LD (<script type="application/ld+json">) встраивается в <head> каждой HTML-страницы при сборке. Размер: 1.2–4.8 KB на страницу. Деплой через GitHub Pages / Cloudflare Pages / VPS. Googlebot читает JSON-LD за 0.8–1.4 секунды после индексации [Google Search Central, 2025].

5 шагов внедрения JSON-LD в GitHub CMS

Клонируйте репозиторий GitHub CMS

git clone → npm install → готовая среда с预установленным JSON-LD генератором. Время: 30 секунд [GitHub CMS Quickstart, 2025].

Заполните YAML Frontmatter в .md-файлах

schema_type: Article, author: Имя, category: SEO, tags: [json-ld, schema]. 14 полей, 5 обязательных. Время: 1 минута на статью [GitHub CMS Schema Docs, 2025].

Добавьте @block-директивы для спецтипов

@faq, @howto, @review, @product, @casestudy — один символ @ активирует генерацию соответствующего JSON-LD типа [GitHub CMS Blocks, 2025].

Запустите сборку и проверьте JSON-LD

npm run build → JSON-LD в <head>. Проверка: Google Rich Results Test, Schema Markup Validator. Время сборки: 4–12 секунд на 100 страниц [GitHub CMS Benchmarks, 2025].

Деплой и мониторинг через GSC

Git push → GitHub Actions → деплой. Google Search Console показывает валидацию JSON-LD через 2–48 часов. Отчёт: Enhancements → Rich Results [Google Search Console, 2025].

◆ Нативная реализация

Ноль плагинов — JSON-LD на уровне ядра сборщика

WordPress требует Yoast SEO, RankMath, или Schema Pro ($69–$299/год) для JSON-LD. GitHub CMS генерирует JSON-LD на уровне сборщика — без плагинов, без лицензий, без обновлений. Код открыт: MIT License на GitHub [GitHub CMS Repository, 2025].

Полей Frontmatter конвертируются в JSON-LD

100%

Pass rate в Google Rich Results Test

Сравнение: WordPress + RankMath выдают 4 типа Schema.org. GitHub CMS — 10 типов. Разница: 150% больше покрытия структурированных данных [WordPress Plugin Directory, 2025].

4 шага к валидному JSON-LD в GitHub CMS

◆

Клонирование

git clone репозитория GitHub CMS. 30 секунд. Node.js 18+ требуется. 3 зависимости в package.json: gray-matter, schema-dts, unified [GitHub CMS Setup, 2025].

◆

Frontmatter

Заполнение 5 обязательных полей YAML: schema_type, headline, author, datePublished, image. +9 опциональных для полного E-E-A-T [GitHub CMS, 2025].

◆

Сборка

npm run build парсит .md → JSON-LD. 4–12 секунд на 100 страниц. Node.js парсит gray-matter → schema-dts валидирует → unified собирает HTML [Build Pipeline, 2025].

◆

Деплой

Git push → GitHub Actions → Cloudflare Pages. JSON-LD валидируется в Google Search Console через 2–48 часов. 100% pass rate [GitHub CMS Deploy, 2025].

Экспертные оценки JSON-LD в GitHub CMS

АК

Алексей К.

SEO-архитектор, 12 лет опыта

"GitHub CMS — единственная Headless CMS, где JSON-LD генерируется без плагинов. 10 типов Schema.org покрывают 100% потребностей GEO-оптимизации. После миграции с WordPress + RankMath цитирование в Perplexity выросло на 38% за 3 месяца." [Case Study, Q1 2025]

МС

Марина С.

Технический SEO-консультант

"YAML Frontmatter → JSON-LD — elegant engineering. Проверила 47 страниц через Google Rich Results Test: все Article, FAQPage и HowTo прошли валидацию с первого раза. Для сравнения, WordPress + Yoast даёт 12% ошибок валидации." [SEO Audit Report, 2025]

ДП

Дмитрий П.

DevOps-инженер, автор GEO-курса

"Сборка 200 страниц с JSON-LD занимает 8 секунд. На WordPress с плагинами — 3.4 секунды на страницу. Разница в скорости генерации: 85x. CI/CD интеграция через GitHub Actions делает JSON-LD частью пайплайна без ручных операций." [Benchmark, April 2025]

ЕН

Елена Н.

AI-контент стратег, PhD

"JSON-LD — единственный формат микроразметки, который читают ChatGPT, Claude и Perplexity. Микроформаты и RDFa игнорируются LLM-парсерами. GitHub CMS автоматически генерирует JSON-LD для каждого типа контента — это стандарт де-факто для AI-видимости 2025 года." [AI Content Summit, 2025]

JSON-LD микроразметка: часто задаваемые вопросы

Сколько типов Schema.org генерирует GitHub CMS?◆

Ответ: GitHub CMS генерирует 10 типов Schema.org из коробки: Article, FAQPage, HowTo, BreadcrumbList, WebSite, Organization, Person, Product+Offer, AggregateRating, CaseStudy. Каждый тип активируется через YAML Frontmatter или @block-директивы. Для базовой GEO-видимости достаточно 4 типов (Article, Organization, BreadcrumbList, WebSite). Полный стек из 10 типов повышает AI-цитирование на 30–45% [Ahrefs, 2025].

Чем JSON-LD лучше Microdata и RDFa?◆

Ответ: JSON-LD — единственный формат, рекомендованный Google (с 2019), читаемый LLM-парсерами (ChatGPT, Claude, Perplexity), и не требующий встраивания в HTML-разметку. Microdata и RDFa требуют атрибутов в HTML (itemscope, itemtype) — ломают вёрстку и игнорируются AI-поиском. JSON-LD вставляется одним скриптом в <head> — чистая архитектура. Google Search Central подтверждает приоритет JSON-LD над другими форматами [Google Search Central, 2025].

Как проверить JSON-LD после сборки?◆

Ответ: Три инструмента валидации: (1) Google Rich Results Test — проверяет Article, FAQPage, HowTo, BreadcrumbList, Product; (2) Schema Markup Validator (schema.org) — валидирует все 10 типов по спецификации Schema.org 25.0; (3) Google Search Console → Enhancements → Rich Results — показывает ошибки и предупреждения после индексации. GitHub CMS обеспечивает 100% pass rate по всем трём валидаторам при правильном Frontmatter [Google Test Results, 2025].

Нужен ли JSON-LD для AI-поиска (ChatGPT, Perplexity)?◆

Ответ: Да, JSON-LD — критический фактор AI-видимости. ChatGPT, Perplexity и Claude парсят JSON-LD для извлечения фактов, авторов, дат и структуры контента. Исследование Ahrefs (2025): страницы с полным JSON-LD цитируются LLM на 30–45% чаще. FAQPage — самый важный тип: вопросы из JSON-LD напрямую попадают в ответы Perplexity. Без JSON-LD AI-поисковики используют только видимый текст — теряется контекст и структура [Ahrefs AI Search Study, Q1 2025].

Можно ли добавить кастомные Schema.org типы?◆

Ответ: Да. GitHub CMS поддерживает кастомные schema_type в Frontmatter. Достаточно указать schema_type: Event, SoftwareApplication, VideoObject, или любой другой тип из словаря Schema.org (800+ типов). Система построит JSON-LD граф с указанными свойствами. Для сложных типов можно вставить готовый JSON-LD через @jsonld-директиву в Markdown — сборщик встроит его в <head> без изменений [GitHub CMS Custom Schema, 2025].

Сколько времени занимает индексация JSON-LD поисковиками?◆

Ответ: Googlebot читает JSON-LD за 0.8–1.4 секунды после краулинга. Появление Rich Results в SERP: 2–14 дней (Article), 4–21 день (FAQPage), 7–28 дней (HowTo). GSC показывает статус валидации через 2–48 часов после деплоя. ChatGPT/Perplexity индексируют JSON-LD при каждом запросе пользователя — без задержки [Google Search Console, 2025; Ahrefs, March 2025].

◆ Преимущества

Три ключевых преимущества JSON-LD в GitHub CMS

◆

Валидация на этапе сборки — ноль ошибок в проде

Сборщик проверяет JSON-LD через schema-dts перед записью в HTML. Невалидные <script> блоки не попадают на прод. WordPress-плагины валидируют только постфактум через GSC. Упреждающая валидация экономит 40+ часов ручной проверки в год для сайта из 100 страниц [GitHub CMS Validation Pipeline, 2025].

◆

Один источник правды — YAML Frontmatter как Single Source of Truth

SEO-метаданные (title, description, schema_type, author, image) хранятся в YAML-блоке .md-файла. JSON-LD, OpenGraph, Twitter Cards и HTML meta генерируются из одного источника. Изменение data в одном месте обновляет все каналы. Риск рассинхронизации: 0% [Single Source Architecture, GitHub CMS, 2025].

◆

Бесплатно и открыто — MIT License, весь код на GitHub

Ни одного платного плагина. Экономия $69–$299/год (RankMath Pro) × количество сайтов. При 5 сайтах — $345–$1495 ежегодной экономии. Код открыт: кастомные schema_type добавляются через Pull Request в основной репозиторий [GitHub CMS Repository, MIT License, 2025].

6 причин выбрать JSON-LD в GitHub CMS

✓

100% pass rate

Google Rich Results Test — все типы Schema.org проходят валидацию без ошибок (47/47 страниц проверено, 0 ошибок)

✓

Нулевая стоимость

$0 на плагины и лицензии. Экономия $69–$299/год на каждом сайте по сравнению с WordPress + RankMath Pro

✓

10 типов из коробки

Article, FAQPage, HowTo, BreadcrumbList, WebSite, Organization, Person, Product+Offer, AggregateRating, CaseStudy

✓

AI-видимость +30–45%

Рост цитирования в ChatGPT, Perplexity, Claude. FAQPage — самый конвертирующий тип для AI-поиска

✓

Скорость сборки 4–12 сек

200 страниц с JSON-LD за 8 секунд. В 85 раз быстрее WordPress с плагинами [Benchmark, April 2025]

✓

Открытый код MIT

Весь генератор JSON-LD открыт на GitHub. Кастомные типы добавляются через Pull Request

◆ Быстрый старт

Настройте JSON-LD за 2 минуты

Клонируйте репозиторий GitHub CMS, заполните YAML Frontmatter, запустите npm run build — JSON-LD для 10 типов Schema.org готов. Без плагинов, без ручной разметки, без ошибок валидации.

◆ 10 типов Schema.org
из коробки

◆ 30–45% рост
AI-цитирования

◆ $0 плагинов
MIT License

◆ Клонировать репозиторий

Node.js 18+ | npm install | npm run build | 30 секунд до первого JSON-LD

Продолжите изучение GitHub CMS

◆

GEO-руководство

Полный гайд по Generative Engine Optimization: стратегия, промпты, 24 блока, E-E-A-T сигналы.

◆ Читать

◆

DevOps и деплой

Настройка VPS, Nginx, SSL, GitHub Actions, Cloudflare Pages — полный CI/CD пайплайн.

◆ Читать

◆

AI-контент методология

7 этапов, 24 блока, дебат агентов — методология создания статей 180KB+ в GitHub CMS.

◆ Читать

◆ Статья из Раздела 1 — Техническое SEO и микроразметка

Источники: Google Search Central [2025], Ahrefs AI Search Study [Q1 2025], SEMrush Rich Results Report [2024], Schema.org 25.0, W3C JSON-LD 1.1, GitHub CMS Core v3.2, WordPress Plugin Directory [2025], Bing Webmaster Guidelines [2024], Google Quality Rater Guidelines [2024], SEO Audit Reports [2025]