Google Play Store MCP

Automatización segura de la ficha de Google Play Store con prueba previa para humanos, CI y agentes MCP.

Este proyecto gestiona el texto de la ficha de Google Play Store a través de la API oficial de Android Publisher. Intencionalmente no es una herramienta de automatización de navegador y no depende de fastlane en tiempo de ejecución.

Por qué existe esto

El trabajo en la ficha de Google Play tiene dos operadores muy diferentes:

• Los humanos y la CI necesitan una CLI que pueda exportar, comparar (diff), validar y aplicar metadatos de la ficha.

• Los agentes necesitan un servidor MCP con herramientas seguras que previsualicen los cambios antes de confirmarlos.

Ambas superficies comparten una biblioteca central para que el comportamiento de seguridad, la comparación, la validación y la semántica de aplicación se mantengan consistentes.

Related MCP server: playstore-release-mcp

Estructura del repositorio

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

Hoja de ruta

Lee ROADMAP.md para conocer el plan actual. Los detalles sobre el reemplazo de capturas de pantalla y medios se encuentran en docs/media-roadmap.md.

Capacidades actuales

• Exportar el texto de la ficha localizada actual desde Google Play.

• Cargar directorios de metadatos al estilo fastlane/supply.

• Previsualizar cambios exactos en el texto localizado.

• Preparar y validar ediciones de Google Play sin confirmarlas.

• Confirmar el texto de la ficha solo con confirmación explícita.

• Usar JSON de cuenta de servicio solo desde una ruta de archivo local.

• Redactar y evitar el registro de secretos.

Las capturas de pantalla y el reemplazo de activos multimedia están diseñados en el cliente central como primitivas de imagen de Android Publisher, pero el primer flujo de trabajo público se centra en el texto de la ficha. La canalización de capturas de pantalla debería ser lo siguiente como un flujo de comparación/aplicación de medios basado en manifiestos.

Instalación

Este repositorio está estructurado como un espacio de trabajo npm. Después de clonar:

npm install
npm run build

Para uso local de MCP después de la compilación:

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

Uso de la CLI

Utiliza un directorio de metadatos al estilo 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

Previsualizar cambios:

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

Validar con Google Play y descartar la edición:

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

Aplicar solo después de revisar:

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

Exportar los metadatos actuales de la ficha:

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

Herramientas MCP

• play_listing_diff: comparación de la ficha en modo de prueba (dry-run).

• play_listing_validate: prepara los cambios de la ficha en una edición de Google Play, los valida y luego elimina la edición.

• play_listing_apply: confirma los cambios de la ficha solo cuando confirm es exactamente APPLY_GOOGLE_PLAY_LISTING_CHANGES.

• play_listing_export: devuelve el texto de la ficha localizada actual como JSON estructurado.

Los clientes MCP aún deben preguntar al usuario antes de llamar a play_listing_apply, ya que modifica una ficha de tienda pública gestionada en la nube.

Modelo de seguridad

Lee docs/security.md antes de usar esto con una aplicación real.

Versión corta:

• Sin scraping de navegador.

• Sin carga de credenciales.

• Sin persistencia de credenciales.

• Sin JSON de cuenta de servicio sin procesar en archivos de configuración.

• Prueba previa y validación antes de aplicar.

• La aplicación requiere confirmación explícita.

• Usar cuentas de servicio de Google Play Console con privilegios mínimos.

Referencias oficiales de la API

• Descripción general de la API de Android Publisher: https://developer.android.com/google/play/developer-api

• Actualizaciones de fichas localizadas: https://developers.google.com/android-publisher/api-ref/rest/v3/edits.listings/update

• Cargas de medios de Android Publisher: https://developers.google.com/android-publisher/upload

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