# seo-google

Субагент seo-google для Claude Code собирает показатели скорости, индексации и органического трафика через API Google. Подключается к делегированным задачам SEO-аудита.

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

## Что делает

seo-google дополняет SEO-аудит данными Google: получает полевые метрики Core Web Vitals через CrUX и результаты PageSpeed Insights. Сначала проверяет учётные данные через `google_auth.py`, затем выбирает доступные проверки. Для запуска нужны скрипты `codex-seo` по пути `${CODEX_SEO_ROOT}/scripts/codex-seo`.

Базовые проверки требуют ключ API. Сервисный аккаунт с доступом к Search Console добавляет запросы и страницы за 28 дней, проверку индексации URL и состояния карт сайта. Доступ к GA4 открывает отчёты об органическом трафике и посадочных страницах. Суммировать строки запросов GSC для общего трафика нельзя: итог по сайту берётся только при `totals_complete: true`.

Если CrUX возвращает 404 из-за недостаточного трафика Chrome, субагент переходит к лабораторным данным PSI. После сбора предлагает PDF-отчёт через `google_report.py`; перед выдачей проверяет статус `PASS`. Если оркестратор передал `output_dir`, промежуточные результаты сохраняются в `output_dir/findings/google.md`, а перед завершением заменяются полными.

## Установка

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- Получить полевые метрики Core Web Vitals и историю CrUX
- Проверить индексацию главной и ключевых страниц
- Собрать запросы и страницы из Search Console за 28 дней
- Выделить посадочные страницы с органическим трафиком в GA4
- Подготовить PDF-отчёт по собранным данным Google

## Примеры запросов агенту
- Подключи seo-google к SEO-аудиту: проверь доступы и собери метрики главной страницы через PSI и CrUX.
- Поручи seo-google проверить индексацию ключевых страниц и состояние карт сайта в Search Console.
- Запусти seo-google для анализа органического трафика за 28 дней и подготовь PDF-отчёт по результатам.

## Похожие
- [blog-google](https://affpapa.org/nevibecode/skills/blog-google.md) — скилл · 2600 установок
- [google-official-seo-guide](https://affpapa.org/nevibecode/skills/google-official-seo-guide.md) — скилл · 1 установка
- [cwv-audit](https://affpapa.org/nevibecode/skills/cwv-audit.md) — скилл · ★ 116 у репозитория
- [seo-monster](https://affpapa.org/nevibecode/mcp/seo-monster.md) — MCP-сервер · ★ 480 у репозитория
- [seo-fundamentals](https://affpapa.org/nevibecode/skills/seo-fundamentals.md) — скилл · 920 установок
- [technical-seo](https://affpapa.org/nevibecode/skills/technical-seo.md) — скилл · ★ 450 у репозитория

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

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

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