Yageo Audit

/yageo-audit

🖥 На маке (дача, август 2026) этот скилл НЕ ЗАПУСКАЕТСЯ. Не пытаться — сказать сразу.

Прежняя версия памятки утверждала, что нет ни одной из трёх составляющих. Две теперь на месте:

• пакет YaGEO — в этой же сборке, ../yageo/ (ставится pip install -e);
• yageo_gate.py — рядом, в scripts/;
• сам задеплоенный сайт — gosmax.ru и остальные проекты остались на выключенной машине.

Не хватает только третьего — задеплоенного сайта под аудит. Его подставляет пользователь.

Если всё же дойдёт до запуска: везде ниже python читать как python3 — команды python на macOS нет. Голый python стоит в четырёх местах: строки 82 (проверка импорта epos_scorer), 108 и 111 (два вызова yageo_gate.py), 160 (indexnow_ping.py). И D:/Yahia/CLAUDE.md → ~/Yahia/CLAUDE.md.

Прогон уже-задеплоенного сайта через YaGEO ЭПОС scorer. Возвращает per-page score 0-100 по 4 dimensions — Экспертность / Полезность / Оригинальность / Содержательность — критериям Yandex AI Search для попадания в ответы Алисы.

Когда применять:

• После деплоя batch SEO-контента (generate_bot_content.py → деплой → audit)
• Weekly snapshot для trend (см. yageo_weekly.py)
• Перед IndexNow ping — отсечь страницы которые сольют ranking

НЕ применять:

• Перед написанием контента — это pre-content market scan через /wordstat-sweep
• Для не-русскоязычного сайта — YaGEO заточен под Yandex AI Search heuristics
• Для SPA без SSR — scoring читает HTML, JS-only страницы вернут пусто

Usage

/yageo-audit <site-or-sitemap-url>
/yageo-audit <site-url> --top 20 --threshold 60
/yageo-audit <project-path>          # auto-detect sitemap

Примеры:

• /yageo-audit https://gosmax.ru/sitemap-0.xml
• /yageo-audit D:/Yahia/active/GosMaxCatalog --top 30
• /yageo-audit https://example.ru/ --threshold 70

Threshold policy

Default --threshold 60 (soft gate). Hard-gate (--threshold 70 блокирующий deploy) применять только после 7-14 дней наблюдения тренда (см. yageo_weekly.py).

Process

Step 1: Determine input mode

Парсинг аргумента:

• URL на *.xml → sitemap mode → --sitemap <url>
• URL на любой другой path → single URL → --urls <url>
• Project path (D:/Yahia/active/<project>) → auto-detect:
  • <project>/app/dist/sitemap-0.xml (Astro/SSG default)
  • <project>/dist/sitemap.xml
  • <project>/public/sitemap.xml
  • Если ничего не нашёл → попросить URL явно

Step 2: Verify YaGEO availability

Проверить что YaGEO установлен:

python -c "from scripts.epos_scorer import score_url; print('OK')"

Если ImportError → установить:

pip install -e D:/Yahia/experiments/YaGEO

Если папки D:/Yahia/experiments/YaGEO нет → клонировать:

git clone https://gitverse.ru/m3taR3B/YaGEO D:/Yahia/experiments/YaGEO
pip install -e D:/Yahia/experiments/YaGEO

Step 3: Verify gate script

Проверить наличие <project>/research/scripts/yageo_gate.py. Если нет — скопировать эталон:

mkdir -p <project>/research/scripts
cp D:/Yahia/active/GosMaxCatalog/research/scripts/yageo_gate.py <project>/research/scripts/

Step 4: Run audit

# Sitemap mode (рекомендованный для batch):
python research/scripts/yageo_gate.py --sitemap <sitemap-url> --top <N> --threshold 60 --workers 5

# Single-URL mode:
python research/scripts/yageo_gate.py --urls <url1> <url2> ... --threshold 60

Параметры:

• --top N — аудит только top-N URLs из sitemap (default 0 = все)
• --threshold 60 — soft default; hard-gate подкручивай только после baseline
• --workers 5 — параллельные HTTP fetch'ы (Yandex может throttle на >10)
• --json — emit summary как JSON для downstream pipe

Exit codes:

• 0 — все страницы ≥ threshold
• 1 — хоть одна < threshold
• 2 — config error (sitemap не найден / YaGEO не установлен)

Step 5: Parse + report

Стандартный stdout формат:

[yageo-gate] auditing N URLs (threshold=60, workers=5)
  PASS  73  E= 75 P= 80 O= 65 S= 72  https://gosmax.ru/
  PASS  68  E= 70 P= 65 O= 60 S= 75  https://gosmax.ru/catalog/business
  FAIL  52  E= 45 P= 55 O= 50 S= 58  https://gosmax.ru/catalog/foo-bot

[yageo-gate] summary: 18/20 pass  avg=64.7/100
  worst 2 URLs (overall < 60):
    52  https://gosmax.ru/catalog/foo-bot
    58  https://gosmax.ru/catalog/bar-bot

Output

Финальный отчёт юзеру:

[yageo-audit] DONE
- Site: <site>
- URLs audited: <N>
- Pass rate: <P>/<N> (<%>) — threshold <T>
- Average score: <avg>/100
- Distribution: E=<eAvg> P=<pAvg> O=<oAvg> S=<sAvg>
- Worst-3 (отдать на rewrite):
  <score> — <url1>
  <score> — <url2>
  <score> — <url3>
- Verdict:
  - GREEN if pass_rate ≥80% and avg ≥65 → ок для IndexNow ping
  - YELLOW if pass_rate 60-80% → fix worst-N перед массовым re-ping
  - RED if pass_rate <60% → review template / GigaChat prompts перед next batch

Next:
- Если GREEN → `python research/scripts/indexnow_ping.py` (см. SEO Content Pipeline)
- Если worst score из-за O (Оригинальность) → re-generate с `GigaChat-2-Max` вместо Lite
- Weekly trend → `yageo_weekly.py` снэпшот в `research/yageo_history/<date>.csv`

Architecture reference

Канонический эталон: D:/Yahia/active/GosMaxCatalog/ Phase B (post-deploy ЭПОС audit). Метрика после Phase B: avg 64.7/100, soft warn threshold 60. Полная методика — секция «SEO Content Pipeline» в D:/Yahia/CLAUDE.md блок «Гейтинг и качество».

YaGEO scorer репозиторий: https://gitverse.ru/m3taR3B/YaGEO (open-source, локально работает без API).

Не путать с /wordstat-sweep