demo-site_audit_spec.json — машиночитаемое ТЗ для ИИ-аудита

Спецификация для автоматизированной проверки страниц сайта demo-site.ru на соответствие утверждённому SEO-плану. Используется как референс для любого ИИ-аудитора (Claude / GPT / Gemini).

Что внутри JSON

demo-site_audit_spec.json
├── $schema_version          версия спецификации
├── spec_name                demo-site.ru SEO audit specification
├── generated_at             дата сборки
├── project                  домен, ниша, регионы, разделы сайта
├── ai_instructions          инструкция для ИИ-аудитора
│   ├── purpose              цель аудита
│   ├── how_to_use           как использовать (5 шагов)
│   ├── audit_procedure      15 шагов проверки
│   ├── report_format        формат отчёта
│   └── severity_definitions определения критичности (critical/major/minor)
├── global_rules             правила для всех страниц
│   ├── url                  правила URL (lowercase, slash, transliteration)
│   ├── meta                 правила Title/Description/H1/canonical/robots
│   ├── content              правила контента (main_query в первых 100 словах)
│   ├── internal_linking     правила перелинковки (хлебные крошки, ссылки)
│   ├── schema_org           правила Schema.org (JSON-LD only)
│   ├── performance          Core Web Vitals и оптимизация
│   ├── eeat                 требования E-E-A-T (для info-article)
│   └── rendering            SSR/SSG требования
├── page_type_specs          8 типов страниц со своими правилами
│   ├── catalog              базовая категория каталога
│   ├── subcatalog           подкатегория/фильтр
│   ├── solution             отраслевая посадочная
│   ├── brand                бренд × категория
│   ├── product_card         карточка товара
│   ├── commercial_landing   гео-страница
│   ├── info_article         блог-статья
│   └── glossary             термин в справочнике
├── pages                    массив 231 утверждённой страницы
│   └── [231 объектов с конкретными ТЗ]
└── meta                     счётчики

Структура одной страницы (pages[i])

{
  "cluster_id": "C0001",
  "url": "/catalog/seyfy/",
  "parent_url": "/catalog/",
  "page_type": "catalog",
  "priority": 1,
  "level": 2,
  "h1": "Сейфы",
  "title": "Сейфы — купить с доставкой по РФ | demo-site.ru",
  "description": "Сейфы в наличии и под заказ от производителя...",
  "main_query": "сейфы",
  "lsi_keywords": ["сейф", "оружейный", "класс", "взломостойкий", ...],
  "schema_required": ["BreadcrumbList", "ItemList", "Organization", "WebSite"],
  "word_count_target": {"min": 1500, "max": 3000, "note": "..."},
  "expected_metrics": {
    "keys_count": 151,
    "sum_freq_rf": 1015102,
    "sum_freq_altai": 0,
    "sum_freq_nsk": 0,
    "sum_freq_kem": 0
  },
  "brands": [],
  "canonical": "/catalog/seyfy/",
  "robots": "index, follow",
  "brief_level": "full",
  "faq_questions": [
    "Какая минимальная партия для заказа сейфы?",
    "Сколько стоит доставка по РФ?",
    ...
  ]
}

Пример системного промпта для ИИ-аудитора

Скопируй этот промпт + приложи к нему demo-site_audit_spec.json и HTML страницы для проверки:

Ты — SEO-аудитор сайта demo-site.ru. У тебя есть спецификация требований 
в формате JSON (приложена). Твоя задача — проверить присланную 
страницу против её ТЗ из спецификации.

Алгоритм:
1. Найди URL присланной страницы в `pages` массиве спецификации.
2. Если страница НЕ найдена в плане — отметь как "page_not_in_plan" 
   и предложи: добавить в план или удалить.
3. Если найдена — извлеки её ТЗ и применяй проверки из 
   `ai_instructions.audit_procedure` (15 шагов).
4. Используй `global_rules` + `page_type_specs[pages[i].page_type]` 
   как набор правил.
5. Возвращай результат строго в формате `ai_instructions.report_format.schema`.

Критичность ошибок определяй по `ai_instructions.severity_definitions`.

В отчёте обязательно укажи:
- url, cluster_id, page_type
- overall_score 0-100
- critical_issues / major_issues / minor_issues (списки)
- passed_checks (что прошло)
- recommendations (приоритезированно)
- checks_detail (по каждой из 15 проверок)

Workflow использования

Сценарий 1. Аудит одной страницы

1. Открыть JSON в ИИ-чате (загрузить файл).
2. Скопировать системный промпт выше.
3. Дать ИИ HTML-исходник страницы или ссылку (если ИИ умеет ходить по URL).
4. Получить отчёт в JSON-формате.
5. Передать отчёт разработчику / контентщику.

Сценарий 2. Массовый аудит после запуска

Подключи JSON к скрипту, который: - Парсит каждый URL из pages[]. - Загружает HTML каждой страницы по URL. - Прогоняет через ИИ (батчами). - Собирает все отчёты в одну Excel-таблицу. - Сортирует по overall_score и critical_issues count.

Получается приоритезированный список «что чинить в первую очередь».

Сценарий 3. Проверка перед публикацией

В админке CMS, при сохранении страницы в published статус, отправлять её HTML на проверку ИИ против JSON-спецификации. Не публиковать, пока нет overall_score >= 75 и critical_issues == [].

Сценарий 4. Регулярный мониторинг

Раз в квартал прогон всех 231 страницы через аудит → сравнение с предыдущим прогоном → видим деградации (что было ok, стало fail) и корректируем.

Что НЕ покрывает спецификация (нужны другие инструменты)

JSON проверяет соответствие плану, не реальные результаты:

Для замера реальных результатов — Яндекс.Метрика + Я.Вебмастер + Topvisor/SE Ranking + аналитика конверсий.

Версионирование

При изменении плана сайта (новые посадочные, удаление страниц, смена структуры URL) — пересобирай JSON и инкрементируй $schema_version.

В отчётах аудита всегда указывается spec_version — чтобы понимать, против какой версии плана проверка прошла.

Контактные точки

JSON собирается из тех же источников, что и Excel-файлы. При обновлении семантики и структуры — пересобирай оба формата синхронно.