Что запускать и когда

Что решаем

Своего аудита я в атлас не кладу и не собираюсь. Хорошие инструменты уже написаны, и моя версия любого из них была бы худшей копией, которую никто не станет поддерживать, включая меня самого.

Чего мне не хватало, так это карты: какой инструмент отвечает на какой вопрос, в каком порядке их запускать и что можно пропустить, когда симптом уже говорит, куда смотреть.

Карту я в итоге написал сам — это команды /atlas: в конце таблицы. Аудита среди них нет: /atlas:start вызывает чужие аудиты и раскладывает их находки по маршруту, а остальные заняты тем, на что аудита не существует, — план текстов, недельный срез цифр, вычитка черновика.

Каждая сторонняя строка ниже — пакет, который стоит у меня на машине. Исключение одно — платный сервис, и лицензию я смотрел в исходном репозитории, а для сервиса — в том, что покупается за деньги.

Шаги

Инструмент	Что делает	Когда браться	Откуда	Лицензия
seo-audit	Технический SEO-аудит: обход, индексация, on-page, скорость страницы	Поиск по сайту не отдаёт ничего или страница выпала из индекса	Skill, coreyhaines31/marketingskills	MIT
geo	Точка входа над GEO-скиллами, отправляет URL в нужный	Хочется одной командой, а какая проверка нужна — ещё непонятно	Skill, zubair-trabzada/geo-seo-claude	MIT
geo-audit	Полный GEO-аудит параллельными субагентами, один сводный балл	Замер до того, как вы что-то меняли, и он же через месяц	Skill, zubair-trabzada/geo-seo-claude	MIT
geo-citability	Оценивает куски текста на то, насколько вероятно модель их процитирует	Страницы написаны, а ассистенты по-прежнему цитируют не вас	Skill, zubair-trabzada/geo-seo-claude	MIT
geo-crawlers	Читает robots.txt, мета-теги и заголовки в карту доступа по агентам	Перед любой работой над цитируемостью и после любой правки на edge	Skill, zubair-trabzada/geo-seo-claude	MIT
geo-llmstxt	Проверяет существующий llms.txt или собирает черновик по структуре сайта	Вы публикуете файл или ссылки в нём протухли	Skill, zubair-trabzada/geo-seo-claude	MIT
geo-schema	Находит и валидирует JSON-LD, генерирует недостающие блоки	Разметки сущности нет или редизайн мог её сломать	Skill, zubair-trabzada/geo-seo-claude	MIT
geo-report	Собирает результаты аудита в один документ для читателя	Действовать по находкам придётся кому-то ещё	Skill, zubair-trabzada/geo-seo-claude	MIT
Playwright MCP	Водит настоящий браузер в вашем профиле, с вашими живыми сессиями	Search Console, консоль магазина, любая панель без пригодного API	npm @playwright/mcp, microsoft/playwright-mcp	Apache-2.0
gws	Одна авторизованная командная строка над API Google Workspace	Держать недельный ряд в Sheet, вытащить экспорт из Drive	npm @googleworkspace/cli, googleworkspace/cli	Apache-2.0
Semrush	Domain Overview по данным Google: позиции, backlinks, Authority Score, панель AI Search	Нужны позиции и ссылки по домену, который изнутри не измерить	Hosted service, semrush.com	Paid subscription, not a skill
/atlas:start	Проводит проект по маршруту, вызывая скиллы аудита в нужных точках	Есть живой URL и нет понимания, какую проблему чинить первой	This repo, plugin/	MIT
/atlas:content-plan	Превращает описание проекта и выгрузку запросов в кластеры, по странице на каждый	Нужно понять, что писать и в каком порядке	This repo, plugin/	MIT
/atlas:report	Недельный срез Search Console и Analytics: что сдвинулось, что делать	Недельный снимок, когда ресурс подтверждён и есть токен	This repo, plugin/	MIT
/atlas:voice	Приводит черновик к STYLE.md до того, как его увидит линтер	Перед тем как открывать pull request в этот репозиторий	This repo, plugin/	MIT

Откуда эти скиллы берутся и где лежит их лицензия

CLI скиллов принимает владельца и имя репозитория. Установка сторонних — две строки:

npx skills add -g coreyhaines31/marketingskills
npx skills add -g zubair-trabzada/geo-seo-claude

Флаг -g здесь обязателен. Без него установщик кладёт скилл в текущий проект, и в соседней папке его уже нет, а сайты вы проверяете из разных мест. Сам пакет ложится в ~/.agents/skills/, а в ~/.claude/skills/ уходит симлинк, поэтому установленное ищут в обоих каталогах сразу.

Лицензия вместе с ними не приезжает. В установленном SKILL.md нет ни строки о лицензии, ни автора, ни имени репозитория, а происхождение выживает в одном месте — в lock-файле, который написал установщик:

cat ~/.agents/.skill-lock.json

Оттуда берём имя репозитория и идём читать лицензию в сам репозиторий.

С чего начинать, когда в индексе пусто

С seo-audit. Он проходит забор, блокировку и canonical за один заход — это быстрее, чем проверять семь вещей руками, и заметно громче, когда одна из них сломана.

На стороне GEO порядок важнее выбора. geo-crawlers раньше geo-citability, всегда. Доступ решает, прочитают ли текст вообще.

Один раз я запустил их наоборот и получил бодрый отчёт о цитируемости страницы, которую неделями не забирал ни один агент.

Зачем нужен сводный балл, если он двигается от чего угодно

geo-audit — для замера, точечный скилл — для починки: сводное число двигается от любого изменения, поэтому само по себе оно говорит мало.

Перезапустите тот же аудит после работы и читайте разницу. Вот на разницу я и смотрю.

Когда браузер — единственный способ попасть в панель

Playwright MCP окупается там, где API просто нет. Панель за логином, консоль без кнопки экспорта.

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

Что покрывает gws, а что нет

gws --help

Список печатает ваша же установленная сборка, и ответ — этот список, а не то, что написано в гайде. Он покрывает Workspace.

Search Console и Analytics в нём нет, и в блоке ниже я как раз выясняю это долгим путём.

Как подключаются четыре команды /atlas:

Две строки в Claude Code — добавить этот репозиторий как marketplace, потом поставить плагин:

/plugin marketplace add Smolevich/pet-project-atlas
/plugin install atlas

Сам аудит остаётся за сторонними скиллами выше, и это осознанно. /atlas:start не проверяет ничего сам, он решает, какой чужой скилл запустить и в каком порядке читать то, что они вернули.

У /atlas:report порог выше остальных: он ходит в API Search Console напрямую, а туда не пускают по одному логину. Нужен проект в Google Cloud с включённым API, OAuth-токен со скоупом webmasters.readonly и quota project — без последнего Search Console отвечает 403. Скилл проверяет это до первого запроса и говорит, чего не хватает.

Остальные три работают сами, но аудитом не заняты: /atlas:content-plan собирает кластеры, /atlas:report ходит в API Search Console, /atlas:voice вычитывает черновик по STYLE.md. Поддерживать это дешевле, чем второй движок аудита.

Что не сработало

• Тянуть числа Search Console через gws. В справке есть форма <api>:<version> для неперечисленных API. Я попробовал searchconsole:v1 и analyticsdata:v1beta, оба вернулись неизвестными сервисами. Эти числа берутся из их собственных API или руками из консоли.
• Искать лицензию внутри установленного скилла. В папках под ~/.agents/skills/ лежат SKILL.md и скрипты. Ни лицензии, ни автора, ни имени репозитория. С папками я в итоге сдался и открыл lock-файл.
• Считать балл аудита работой. Сводное число двигается от чего угодно. Поведение мне меняла одна строка отчёта. Агент, получивший 403. Кусок текста, который никто не мог процитировать.
• Гонять проверки цитируемости, пока crawler заблокирован. Отчёт бодро оценивал мою прозу. Страницу неделями не забирал ни один агент. Я ставил оценку документу, который никто не скачивал.
• Водить чистый профиль браузера по панелям за логином. Каждый запуск начинался с экрана входа. До панели доезжает только профиль с живой сессией.
• Верить, что этот список стабилен. У сторонних скиллов между обновлениями меняются владельцы, лицензии и поведение. Проверяйте репозиторий в день установки. И ещё раз перед тем, как копировать что-то оттуда к себе.

Проверить

• cat ~/.agents/.skill-lock.json и прочитать sourceUrl каждого установленного скилла. Это и есть репозиторий, чья лицензия на вас действует.
• Открыть этот репозиторий и прочитать в нём файл LICENSE. Файла нет — условия неизвестны, а неизвестны значит не распространять.
• Запустить gws --help и найти свой сервис в напечатанном списке. Отсутствующий сервис отсутствует, что бы ни писали в гайде.
• Запустить seo-audit по странице, которую вы уже починили. Если отчёт всё ещё её ругает, починка не доехала до прода.
• Запустить geo-crawlers из сети, которая не ваша. Карта доступа, снятая изнутри вашей сети, прячет правила на edge.

Что платная строка измеряет, а что нет — отдельная страница: что измеряет платный трекер позиций.

Что из этого запускать на ваш симптом — это Инструменты.