Инструменты для AI-агента, доступ к аналитике Яндекса там, где официального API нет
Рабочий агент регулярно берёт данные из аналитики Яндекса - счётчики Метрики, поисковую выдачу, Вебмастер, Вордстат - для задач по продвижению собственных проектов. Весь готовый инструментарий для агентов в основном написан под Google, а то немногое, что есть под Яндекс, не закрывало мои задачи, и каждый запрос превращался в ручное хождение по интерфейсам.
Взял за основу open-source скиллы (polyakov-claude-skills) и переработал под свои задачи: четыре расширения, 8051 строка, 58 скриптов. Каждое умеет кэшировать ответы и укладываться в квоты, потому что агент, дёргающий API в цикле, выжигает лимиты быстрее человека.
Авторизация
Токен доступа собирается сам: подписанный JWT из ключа сервисного аккаунта обменивается на IAM-токен, тот кэшируется и обновляется до истечения. Ручной шаг «сходи получи токен» из процесса убран целиком - иначе агент упирается в него в самый неподходящий момент.
Раздел без API
У части Вебмастера публичного API нет вообще. Данные оттуда достаются из самой страницы: по авторизованной сессионной куке загружается HTML, из него вынимается объект начального состояния, дальше обычный разбор. Сюрприз ждал в сертификатах: Python из коробки не несёт корневые сертификаты, а лежат они в разных местах на macOS, Debian, RHEL и в Homebrew - пришлось перебирать наборы, иначе скрипт падал на чужой машине по причине, не имеющей отношения к делу.
Отдельная часть - разбор выгрузок из Директа: сегментация фраз, сборка составных запросов, поиск упущенного спроса. Тесты к ней работают на локальных файлах и не ходят в сеть, поэтому прогон не зависит ни от квот, ни от доступности сервиса.
Проверка практикой
Кэш скриптов ссылается на реальные проекты, а не на демо-счётчики: инструменты писались под собственные задачи по продвижению и с тех пор используются в работе. Это, пожалуй, главный критерий полезности такого расширения - им пользуются после того, как закончился энтузиазм от написания.