Google Play Store MCP

Sichere, auf Probeläufe ausgelegte Automatisierung für Google Play Store-Einträge für Menschen, CI und MCP-Agenten.

Dieses Projekt verwaltet Google Play Store-Eintragstexte über die offizielle Android Publisher API. Es ist bewusst kein Browser-Automatisierungstool und hängt zur Laufzeit nicht von fastlane ab.

Warum existiert dieses Projekt?

Die Arbeit an Google Play-Einträgen hat zwei sehr unterschiedliche Anwendergruppen:

• Menschen und CI benötigen eine CLI, die Metadaten für Einträge exportieren, vergleichen, validieren und anwenden kann.

• Agenten benötigen einen MCP-Server mit sicheren Tools, die Änderungen vor dem Übernehmen in einer Vorschau anzeigen.

Beide Oberflächen nutzen eine gemeinsame Kernbibliothek, sodass Sicherheitsverhalten, Diffing, Validierung und Anwendungssemantik konsistent bleiben.

Related MCP server: playstore-release-mcp

Repo-Struktur

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

Lesen Sie ROADMAP.md für den aktuellen Plan. Details zum Austausch von Screenshots und Medien finden Sie in docs/media-roadmap.md.

Aktuelle Funktionen

• Exportieren aktueller lokalisierter Eintragstexte aus Google Play.

• Laden von Metadaten-Verzeichnissen im fastlane/supply-Stil.

• Vorschau exakter lokalisierter Textänderungen.

• Staging und Validierung von Google Play-Bearbeitungen ohne deren Übernahme.

• Übernahme von Eintragstexten nur nach expliziter Bestätigung.

• Verwendung von Service-Account-JSON ausschließlich über einen lokalen Dateipfad.

• Schwärzung und Vermeidung der Protokollierung von Geheimnissen.

Der Austausch von Screenshots und Medien-Assets ist im Kern-Client als Android Publisher-Bild-Primitive konzipiert, aber der erste öffentliche Workflow konzentriert sich auf Eintragstexte. Die Screenshot-Pipeline sollte als nächstes als manifestgesteuerter Medien-Diff/Apply-Workflow folgen.

Installation

Dieses Repo ist als npm-Workspace strukturiert. Nach dem Klonen:

npm install
npm run build

Für die lokale MCP-Nutzung nach dem Build:

{
  "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-Nutzung

Verwenden Sie ein Metadaten-Verzeichnis im fastlane/supply-Stil:

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

Änderungen in der Vorschau anzeigen:

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

Mit Google Play validieren und die Bearbeitung verwerfen:

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

Erst nach Überprüfung anwenden:

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

Aktuelle Metadaten der Einträge exportieren:

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

MCP-Tools

• play_listing_diff: Probelauf für den Vergleich von Einträgen.

• play_listing_validate: Staged Eintragsänderungen in einer Google Play-Bearbeitung, validiert diese und löscht dann die Bearbeitung.

• play_listing_apply: Übernimmt Eintragsänderungen nur, wenn confirm exakt APPLY_GOOGLE_PLAY_LISTING_CHANGES entspricht.

• play_listing_export: Gibt den aktuellen lokalisierten Eintragstext als strukturiertes JSON zurück.

MCP-Clients sollten den Benutzer dennoch vor dem Aufruf von play_listing_apply fragen, da dies einen in der Cloud verwalteten öffentlichen Store-Eintrag ändert.

Sicherheitsmodell

Lesen Sie docs/security.md, bevor Sie dies mit einer echten App verwenden.

Kurzfassung:

• Kein Browser-Scraping.

• Kein Hochladen von Anmeldedaten.

• Keine dauerhafte Speicherung von Anmeldedaten.

• Kein rohes Service-Account-JSON in Konfigurationsdateien.

• Probelauf und Validierung vor der Anwendung.

• Anwendung erfordert explizite Bestätigung.

• Verwendung von Service-Accounts mit minimalen Berechtigungen (Least-Privilege) für die Play Console.

Offizielle API-Referenzen

• Android Publisher API Übersicht: https://developer.android.com/google/play/developer-api

• Lokalisierte Eintragsaktualisierungen: https://developers.google.com/android-publisher/api-ref/rest/v3/edits.listings/update

• Android Publisher Medien-Uploads: https://developers.google.com/android-publisher/upload

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