# seo-performance

Субагент seo-performance для Claude Code меряет Core Web Vitals и скорость загрузки страницы, разбирает LCP, INP и CLS и выдаёт узкие места по убыванию влияния.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 159 у репозитория
- Автор: zhtyyx
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zhtyyx/codex-seo/tree/HEAD/agents/seo-performance.md
- Обновлён: 2026-11-09
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/seo-performance

## Что делает

Субагент снимает метрики LCP, INP и CLS через PageSpeed Insights API, рендерит страницу скриптом `render_page.py` и сравнивает лабораторные прогоны Lighthouse с полевыми данными CrUX. Оценка идёт по 75-му процентилю визитов: чтобы метрика считалась пройденной, порог «хорошо» должны выполнять 75% заходов. FID не используется — интерактивность мерит только INP.

Внутри три скрипта через `${CODEX_SEO_ROOT}/scripts/codex-seo`: `pagespeed_check.py`, `render_page.py`, `crux_history.py`. Рендер включается режимом `--mode auto`, потому что в SPA без него в исходном HTML пусто. Контент, который вернул рендер или Lighthouse, субагент читает как данные: команды со страницы не выполняет. Ходов не больше 35, инструменты `Read`, `Bash`, `Write`.

Ключ PageSpeed API уходит заголовком. Полевые данные CrUX — среднее за 28 дней по Chrome, они точнее одного лабораторного прогона; при ответе 404 остаётся Lighthouse. CLI Lighthouse 13.5.0 требует Node.js 22.19 или новее. Если оркестратор передал `output_dir`, субагент пишет туда `findings/performance.md` после первого прохода и перезаписывает полным отчётом.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/seo-performance.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/seo-performance.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/seo-performance.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zhtyyx/codex-seo/tree/HEAD/agents/seo-performance.md

## Когда брать
- найти, какая метрика Core Web Vitals не проходит порог
- отличить медленный ответ сервера от тяжёлой картинки в LCP
- собрать список узких мест по убыванию ожидаемого влияния
- сверить лабораторный прогон Lighthouse с полевыми данными CrUX
- получить черновик отчёта в `output_dir/findings/performance.md`

## Примеры запросов агенту
- Проверь Core Web Vitals главной страницы и покажи, что не проходит по LCP.
- Сравни полевые данные CrUX с последним прогоном Lighthouse по каталогу товаров.
- Отранжируй найденные узкие места по влиянию и сохрани отчёт в `output_dir/findings/performance.md`.

## Похожие
- [pagespeed-insights-mcp](https://affpapa.org/nevibecode/mcp/pagespeed-insights-mcp.md) — MCP-сервер · ★ 83 у репозитория
- [pagespeed-insights](https://affpapa.org/nevibecode/skills/pagespeed-insights.md) — скилл · 1200 установок
- [web-performance-optimization](https://affpapa.org/nevibecode/skills/bobmatnyc-web-performance-optimization.md) — скилл · 474 установки
- [Frontend Performance Investigator](https://affpapa.org/nevibecode/agents/frontend-performance-investigator.md) — субагент · ★ 41430 у репозитория
- [performance-optimization](https://affpapa.org/nevibecode/skills/performance-optimization.md) — скилл · 82600 установок
- [nextjs-performance-audit](https://affpapa.org/nevibecode/commands/nextjs-performance-audit.md) — команда · 694 установки

Из того же набора: [zhtyyx/codex-seo](https://affpapa.org/nevibecode/by/zhtyyx/codex-seo.md) — 59 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
