Schema.org для AI

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Что такое GEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "GEO (Generative Engine Optimization) — оптимизация контента для AI-поисковиков, таких как Perplexity, ChatGPT Search, Google AI Overviews. Цель — быть процитированным в сгенерированном ответе."
      }
    },
    {
      "@type": "Question",
      "name": "Чем GEO отличается от SEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEO оптимизирует для позиции в списке ссылок. GEO оптимизирует для цитирования внутри AI-сгенерированного ответа. GEO дополняет SEO, а не заменяет его."
      }
    }
  ]
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Как добавить Schema.org разметку на Nuxt-сайт",
  "description": "Пошаговая инструкция по добавлению структурированных данных через @nuxtjs/schema-org.",
  "totalTime": "PT15M",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Установите модуль",
      "text": "Выполните npm install @nuxtjs/schema-org и добавьте модуль в nuxt.config.ts."
    },
    {
      "@type": "HowToStep",
      "name": "Настройте базовую конфигурацию",
      "text": "Добавьте schemaOrg в секцию modules и укажите параметры identity в nuxt.config.ts."
    },
    {
      "@type": "HowToStep",
      "name": "Добавьте разметку в компоненты",
      "text": "Используйте useSchemaOrg() composable для добавления структурированных данных на уровне страницы."
    }
  ]
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "Schema.org для AI: полное руководство",
  "description": "Как использовать структурированные данные для оптимизации контента под AI-поисковики.",
  "datePublished": "2026-02-23",
  "dateModified": "2026-02-23",
  "author": {
    "@type": "Person",
    "name": "Автор",
    "url": "https://example.com/about"
  },
  "publisher": {
    "@type": "Organization",
    "name": "AI-портал",
    "url": "https://example.com"
  },
  "proficiencyLevel": "Beginner",
  "dependencies": "HTML, базовые знания JSON"
}
</script>

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxtjs/schema-org'],

  schemaOrg: {
    identity: {
      type: 'Organization',
      name: 'AI-портал',
      url: 'https://example.com',
      logo: 'https://example.com/logo.png',
    },
  },
})

<!-- pages/geo/schema-org-for-ai.vue -->
<script setup lang="ts">
// Автоматическая генерация Article разметки
useSchemaOrg([
  defineArticle({
    headline: 'Schema.org для AI',
    description: 'Структурированные данные для AI-краулеров',
    datePublished: '2026-02-23',
    dateModified: '2026-02-23',
    author: {
      name: 'AI-портал',
    },
  }),
])
</script>

// composables/useAutoFaq.ts
interface FaqItem {
  question: string
  answer: string
}

/**
 * Автоматически генерирует FAQPage-разметку Schema.org
 * на основе массива вопросов-ответов.
 */
export function useAutoFaq(items: FaqItem[]) {
  if (!items.length) return

  useSchemaOrg([
    {
      '@type': 'FAQPage',
      'mainEntity': items.map(item => ({
        '@type': 'Question',
        'name': item.question,
        'acceptedAnswer': {
          '@type': 'Answer',
          'text': item.answer,
        },
      })),
    },
  ])
}

// Использование
// useAutoFaq([
//   { question: 'Что такое GEO?', answer: '...' },
//   { question: 'Зачем Schema.org?', answer: '...' },
// ])

// scripts/validate-schema.ts
import { readFileSync, readdirSync } from 'node:fs'
import { resolve } from 'node:path'

interface ValidationResult {
  file: string
  valid: boolean
  errors: string[]
}

function validateJsonLd(html: string): string[] {
  const errors: string[] = []
  const regex = /<script type="application\/ld\+json">([\s\S]*?)<\/script>/g

  let match: RegExpExecArray | null = null
  while ((match = regex.exec(html)) !== null) {
    try {
      const data = JSON.parse(match[1])

      // Проверяем обязательные поля
      if (!data['@context']) {
        errors.push('Missing @context')
      }
      if (!data['@type']) {
        errors.push('Missing @type')
      }

      // Для FAQPage — проверяем наличие mainEntity
      if (data['@type'] === 'FAQPage' && !data.mainEntity?.length) {
        errors.push('FAQPage: mainEntity is empty')
      }

      // Для Article — проверяем даты
      if (
        data['@type'] === 'Article'
        || data['@type'] === 'TechArticle'
      ) {
        if (!data.datePublished) {
          errors.push('Article: missing datePublished')
        }
        if (!data.author) {
          errors.push('Article: missing author')
        }
      }
    }
    catch (e) {
      errors.push(`Invalid JSON: ${(e as Error).message}`)
    }
  }

  return errors
}