JSON-LD (JSON Linked Data) — это формат для структурированных данных на веб-страницах. Краулеры вроде Googlebot лучше понимают смысл сайта, могут показывать более богатые ссылки-превью и даже выше ранжировать страницу в выдаче.
Автор (Ethan Hawksley) собрал свой сайт и за четыре месяца потратил около 100 часов на разработку, включая добавление JSON-LD на каждую страницу. Скрипт с типом application/ld+json вставляется в <head>. Движок браузера его не выполняет — его парсят только краулеры. Схему данных задаёт @context: https://schema.org. Внутри @graph лежат узлы с @type, @id и свойствами. Если узел с одинаковым @id встречается на нескольких страницах, краулеры сливают его свойства, а LLM-парсеры (которые читают только одну страницу) — нет. id лучше делать URL с хэшем (#website).
Для главной страницы нужен узел WebSite: название (name), альтернативные имена, описание, язык, ссылка на издателя (Person). На других страницах можно оставить урезанную версию. Person обязателен везде: имя, фото, ссылки на профили (sameAs) — это помогает поисковикам и LLM решать, кого цитировать. ProfilePage описывает страницу о человеке (например, «О себе»), её важно связывать с WebSite через isPartOf и с Person через mainEntity.
SoftwareApplication добавляют для проектов: название, тип (например, MultimediaApplication), цена (даже для open source ставят 0), ссылка на репозиторий. BreadcrumbList — хлебные крошки для всех страниц кроме корневой. Он контролирует, как поисковик показывает путь к странице. CollectionPage — для страниц со списками (например, архив блога). Blog — мостик между сайтом и отдельными постами. BlogPosting — для каждой публикации: заголовок, описание, даты, автор (для личного сайта publisher тоже ссылается на Person).
Минимальный набор для статического сайта: WebSite, ProfilePage и Person на корневой странице.