# schema-org
## Что такое Schema.org JSON-LD?
**Schema.org JSON-LD** — машиночитаемые метаданные, встраиваемые в страницу блоком `
```
Разметка встраивается в `` или `` и не влияет на визуальное отображение — она видна только поисковикам и AI-агентам.
## Зачем сайту Schema.org JSON-LD?
Schema.org решает фундаментальную проблему: HTML содержит контент, но не говорит, **что** он значит. Параграф текста — это отзыв? Расписание? Инструкция? Без разметки AI угадывает. С разметкой — знает точно.
**Для [GEO](/glossary/geo) и [AEO](/glossary/aeo):**
AI-помощники (ChatGPT, Perplexity, Google AI Overview) используют структурированные данные при формировании ответов. Страница с `FAQPage` цитируется как готовый ответ — это основной инструмент [AEO](/glossary/aeo). Страница с `Product` и `aggregateRating` попадает в rich snippets.
**Для AI-агентов:**
Агент извлекает данные из разметки быстрее и точнее, чем из свободного HTML.
**Практические эффекты:**
- `FAQPage` → rich snippet «Вопрос-ответ», цитирование в AI-ответах
- Рецепт/статья → rich snippet с изображением
- `Organization` → Knowledge Panel
- `SoftwareApplication` → оценка в поиске по приложениям
## Как реализовать Schema.org JSON-LD?
**Минимальный набор для большинства сайтов:**
```html
```
**FAQ страница:**
```json
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Что такое agent-readiness?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Agent-readiness — это степень готовности сайта..."
}
}
]
}
```
**Приоритетные типы для agent-readiness:**
| Тип | Когда использовать |
|---|---|
| `WebSite` | Главная страница |
| `Organization` | Страница «О нас» |
| `SoftwareApplication` | Главная для SaaS/приложений |
| `FAQPage` | Страница FAQ |
| `Article` / `TechArticle` | Статьи, документация |
| `DefinedTerm` | Страницы глоссария |
| `Service` | Страница услуг/тарифов |
**Для Astro (наш подход):**
```astro
---
const schema = {
'@context': 'https://schema.org',
'@type': 'SoftwareApplication',
name: 'Agent Ready Scanner',
url: 'https://agentsready.io',
};
---
```
**Валидация:** перед деплоем проверьте на [validator.schema.org](https://validator.schema.org/) — должно быть 0 errors, желательно 0 warnings.
## Как мы проверяем Schema.org?
Наш сканер делает `GET /` (главную страницу) и проверяет:
1. **Наличие блоков JSON-LD** — ищем все `