Google Play Store MCP

Безопасная автоматизация описаний в Google Play Store с предварительной проверкой для людей, CI и агентов MCP.

Этот проект управляет текстом описания в Google Play Store через официальный Android Publisher API. Он намеренно не является инструментом автоматизации браузера и не зависит от fastlane во время выполнения.

Зачем это нужно

Работа с описаниями в Google Play ведется двумя принципиально разными способами:

• Людям и CI нужен CLI, который может экспортировать, сравнивать (diff), проверять и применять метаданные описания.

• Агентам нужен MCP-сервер с безопасными инструментами, которые позволяют просматривать изменения перед их фиксацией.

Оба интерфейса используют одну и ту же базовую библиотеку, поэтому поведение безопасности, сравнение, проверка и семантика применения остаются согласованными.

Related MCP server: playstore-release-mcp

Структура репозитория

packages/core   Typed Android Publisher API client, listing manifests, diff, validate, apply
packages/cli    gpstore command for humans and CI
packages/mcp    MCP stdio server for agent tools
examples        Safe example metadata, with no credentials
docs            Security and operating notes

Дорожная карта

Ознакомьтесь с ROADMAP.md для получения информации о текущем плане. Подробности о замене скриншотов и медиафайлов находятся в docs/media-roadmap.md.

Текущие возможности

• Экспорт текущего локализованного текста описания из Google Play.

• Загрузка метаданных в стиле fastlane/supply.

• Предварительный просмотр точных изменений локализованного текста.

• Подготовка и проверка правок в Google Play без их фиксации.

• Фиксация текста описания только после явного подтверждения.

• Использование JSON-файла сервисного аккаунта только с локального пути.

• Редактирование и предотвращение логирования секретных данных.

Замена скриншотов и медиа-активов заложена в ядро клиента как примитивы изображений Android Publisher, но первый публичный рабочий процесс сосредоточен на тексте описания. Конвейер скриншотов должен стать следующим этапом в виде процесса сравнения/применения медиа на основе манифеста.

Установка

Этот репозиторий создан как рабочая область npm. После клонирования:

npm install
npm run build

Для локального использования MCP после сборки:

{
  "mcpServers": {
    "google-play-store": {
      "command": "node",
      "args": ["/absolute/path/to/google-play-store-mcp/packages/mcp/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account.json"
      }
    }
  }
}

Использование CLI

Используйте каталог метаданных в стиле fastlane/supply:

metadata/android/en-US/title.txt
metadata/android/en-US/short_description.txt
metadata/android/en-US/full_description.txt
metadata/android/es-US/title.txt
metadata/android/es-US/short_description.txt
metadata/android/es-US/full_description.txt

Предварительный просмотр изменений:

gpstore diff \
  --package-name com.example.app \
  --metadata-dir ./metadata/android \
  --credentials /absolute/path/to/service-account.json

Проверка в Google Play и отмена правки:

gpstore validate \
  --package-name com.example.app \
  --metadata-dir ./metadata/android \
  --credentials /absolute/path/to/service-account.json

Применение только после проверки:

gpstore apply \
  --package-name com.example.app \
  --metadata-dir ./metadata/android \
  --credentials /absolute/path/to/service-account.json \
  --confirm APPLY_GOOGLE_PLAY_LISTING_CHANGES

Экспорт текущих метаданных описания:

gpstore export \
  --package-name com.example.app \
  --out ./metadata/android \
  --credentials /absolute/path/to/service-account.json

Инструменты MCP

• play_listing_diff: предварительный просмотр изменений описания (dry-run).

• play_listing_validate: подготавливает изменения описания в правке Google Play, проверяет их, а затем удаляет правку.

• play_listing_apply: фиксирует изменения описания только тогда, когда confirm в точности равен APPLY_GOOGLE_PLAY_LISTING_CHANGES.

• play_listing_export: возвращает текущий локализованный текст описания в виде структурированного JSON.

Клиенты MCP должны запрашивать подтверждение у пользователя перед вызовом play_listing_apply, так как это изменяет публичное описание приложения в облаке.

Модель безопасности

Прочитайте docs/security.md перед использованием этого инструмента с реальным приложением.

Кратко:

• Никакого парсинга браузера.

• Никакой загрузки учетных данных.

• Никакого сохранения учетных данных.

• Никакого необработанного JSON сервисного аккаунта в файлах конфигурации.

• Предварительная проверка (dry-run) перед применением.

• Применение требует явного подтверждения.

• Использование сервисных аккаунтов Play Console с минимальными привилегиями.

Официальные ссылки на API

• Обзор Android Publisher API: https://developer.android.com/google/play/developer-api

• Обновления локализованных описаний: https://developers.google.com/android-publisher/api-ref/rest/v3/edits.listings/update

• Загрузка медиафайлов Android Publisher: https://developers.google.com/android-publisher/upload

• MCP TypeScript SDK: https://modelcontextprotocol.io/docs/sdk