Google Play Store MCP

人間、CI、およびMCPエージェントのための、安全でドライランを優先するGoogle Playストア掲載情報の自動化ツールです。

このプロジェクトは、公式のAndroid Publisher APIを通じてGoogle Playストアの掲載テキストを管理します。意図的にブラウザ自動化ツールではなく、実行時にfastlaneに依存しません。

なぜこのツールが存在するのか

Google Playの掲載作業には、大きく分けて2つの異なる操作形態があります。

• 人間やCIには、掲載メタデータのエクスポート、差分確認、検証、適用ができるCLIが必要です。

• エージェントには、変更をコミットする前にプレビューできる安全なツールを備えたMCPサーバーが必要です。

どちらのインターフェースも1つのコアライブラリを共有しているため、セキュリティ動作、差分確認、検証、適用セマンティクスが一貫しています。

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: 掲載情報のドライラン差分確認。

• 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を含めません。

• 適用前にドライランと検証を行います。

• 適用には明示的な確認が必要です。

• 最小権限の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