gplay CLI

Один бинарник управляет Google Play Console: релизы и раскатка, подписки, отзывы и краши, каждая команда отвечает в JSON

  • 284 ★ репозитория
  • Последний коммит
  • MIT
CLI

Широкий доступ

Почему такой уровень

  • Выпускает релизы в продакшен-треки Google Play и меняет карточки магазина, подписки и цены
  • Управляет пользователями и правами Play Console, смотрит финансовые отчеты, покупки и возвраты
  • Ключ сервисного аккаунта дает доступ ко всем разрешенным ему приложениям
Все причины и проверки

tamtom/play-console-cli

Установка

Ручная установка

brew install tamtom/tap/gplay

Сначала выполните `brew tap tamtom/tap`. Есть и автономные бинарники: `install.sh` для macOS и Linux, `install.ps1` для Windows.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Выпускает релизы в продакшен-треки Google Play и меняет карточки магазина, подписки и цены
  • Управляет пользователями и правами Play Console, смотрит финансовые отчеты, покупки и возвраты
  • Ключ сервисного аккаунта дает доступ ко всем разрешенным ему приложениям

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

gplay — консольная программа на Go, которая заменяет ручную работу в Google Play Console для разработчика Android. Она выпускает приложения, создает подписки и разовые покупки, проверяет покупки на сервере, следит за крашами и отзывами. Работа идет через документированные API Google, закрытых адресов и автоматизации браузера в ней нет. В программе больше 250 команд поверх девяти API: Android Publisher, Play Developer Reporting, Checks, два административных API Play Games, Managed Google Play, Play Integrity, Android Developer ID Status и Cloud Storage для отчетов. Релиз одной командой: `gplay release --package com.example.app --track production --bundle app.aab --rollout 0.1`. Есть поэтапная раскатка с паузой, продвижение между треками, карточки магазина и скриншоты на всех языках. Вывод всегда компактный JSON, команды не ждут ввода, поэтому ими управляет агент. `gplay install-skills` ставит набор готовых скиллов из зафиксированного коммита с проверкой деревьев. Начальная настройка публичного приложения, первая загрузка, включение Play App Signing и юридические декларации по-прежнему делаются вручную в консоли.

Для кого. Для Android-разработчиков и релиз-инженеров, которые выпускают приложения в Google Play и хотят поручить рутину Claude Code, Codex, Cursor или Gemini CLI.

Подходит, если

  • Нужно выложить AAB на внутренний трек или в продакшен с поэтапной раскаткой одной командой
  • Подписки с базовыми планами, пробным периодом и региональными ценами надо создать из файла JSON
  • Каждую неделю нужна сводка по крашам, ANR, установкам и отзывам из выгрузок Google Play
  • Покупки нужно проверять на сервере, а возвраты и заказы смотреть из терминала
  • Релиз встраивается в CI: GitHub Actions или GitLab, с проверками перед отправкой

Не подходит, если

  • Приложение еще не создано: первую настройку, загрузку и юридические декларации приходится делать вручную в консоли
  • Нужны закрытые функции Play Console, которых нет в официальных API: gplay закрытые адреса не использует
  • Проект на iOS: инструмент работает только с Google Play
  • Вам хватает загрузки AAB: для одной выгрузки подойдет Fastlane supply или gradle-play-publisher

Пример запроса к агенту

Выложи этот AAB на внутренний трек Google Play и покажи статус раскатки

Ограничения

Для входа нужен сервисный аккаунт Google Cloud с доступом в Play Console. Настройка: `gplay setup --auto` ставит `gcloud`, создает аккаунт и открывает консоль для шага выдачи прав, который выполняется вручную. Начальная публикация, Play App Signing и юридические декларации остаются в консоли. Сборка из исходников требует Go 1.27.3 или новее. После первой выгрузки метаданных или релиза при установленном `gh` программа предлагает поставить звезду репозиторию, но сама ничего не ставит и ждет вашего согласия: подавить подсказку можно переменной `GPLAY_NO_STAR_PROMPT=1`.

Как отключить. Удалите бинарник командой `brew uninstall gplay` или вручную, а скиллы уберите из папки скиллов агента. Сервисный аккаунт Google Cloud отключите в Play Console, если он больше не нужен.

Частые вопросы

Как поставить gplay и подключить к Claude Code?

Выполните `brew tap tamtom/tap` и `brew install tamtom/tap/gplay` либо скрипт `install.sh`. Затем `gplay install-skills` поставит готовые скиллы для агентов, а `gplay install-skills --preview` покажет план без записи.

Как войти в Google Play через gplay?

Через сервисный аккаунт. Самый короткий путь — `gplay setup --auto`: он создаст аккаунт и ключ, а вручную останется выдать ему права в Play Console. Если ключ уже есть, выполните `gplay auth login --service-account /path/to/key.json`, затем `gplay auth doctor`.

Чем gplay отличается от Fastlane supply?

Fastlane supply и gradle-play-publisher загружают AAB, ведут треки, раскатки и карточки. gplay добавляет подписки с базовыми планами, проверку покупок и возвраты, показатели стабильности, отзывы, отчеты, управление пользователями и частные приложения Managed Google Play, а вывод у него сразу JSON.

Что gplay не может сделать сам?

Начальную настройку публичного приложения, первую загрузку, включение Play App Signing и юридические декларации нужно выполнить в консоли. Команда `gplay capabilities` отделяет официальные сценарии от ручных и неподдерживаемых.

Как агенту найти нужную команду среди 250?

`gplay search` ранжирует команды, примеры и флаги локально, а `gplay schema` содержит 218 проверенных конечных точек и описания запросов без сети и ключей.

Обсуждение

Вопросов и отзывов пока нет.

Google Play Developer MCP

google-play-developer-mcp

MCP-сервер для Google Play Console: релизы и треки, поэтапная раскатка, магазинные страницы, отзывы и подписки из чата с агентом

MCP-серверШирокий доступ11Звезды репозитория
Официальный

Официальные 30 скиллов команды Android: Jetpack Compose, обновление AGP 9, R8, профилирование Perfetto, Navigation 3, CameraX и политики Google Play

СкиллРасширенный доступ10 тыс.Звезды репозитория

Скиллы и CLI, чтобы Claude Code, Codex и OpenCode управляли Android-телефоном: открывали приложения, нажимали, вводили текст и тестировали сценарии

СкиллШирокий доступ1,8 тыс.Звезды репозитория

Скриншоты и превью-видео для App Store и Google Play: агент проходит приложение на симуляторе, ставит кадры в рамку и проверяет их по правилам магазинов

СкиллРасширенный доступ2,6 тыс.Звезды репозитория

Консольный отладчик Android на протоколе JDWP: агент ставит точки останова и читает переменные, ответы приходят в JSON

CLIРасширенный доступ276Звезды репозитория

Artemis

artemis

Официальный

Каркас Google для управления реальным устройством Android или эмулятором по инструкциям на естественном языке: UI-тесты и повседневные задачи

CLIШирокий доступ15,6 тыс.Звезды репозитория

Коротко о README

README начинается с описания gplay и границы официальных API, затем идут установка через Homebrew или скрипт, вход по сервисному аккаунту и примеры релиза, подписок и отзывов. Дальше перечислены сильные стороны, подключение к агентам и сравнение с Fastlane supply и gradle-play-publisher.

Бейдж для README

Сообщить о проблеме

Foxx AIgplay
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.