PubShip

PubShip

Google Play のデベロッパーワークフローを、自分のコンピューターから。 MCP クライアントからリリースを確認し、レビューやレポートを把握して、明示的に許可された変更を準備できます。

ローカルで起動する

Play Console でご利用のアプリに対する権限を持つ、ご自身のサービスアカウントを使用してください。秘密鍵を含む JSON ファイルは、このリポジトリの外に保管してください。実行する操作に必要な権限だけを付与してください。認証情報をアシスタントとの会話に貼り付けないでください。

export GOOGLE_APPLICATION_CREDENTIALS=/absolute/private/path/service-account.json
export GOOGLE_PLAY_PACKAGES=com.example.app
uvx pubship

これにより、MCP クライアントからの接続を待機する stdio サーバーが起動します。認証情報を使わずにインストールを確認するには、次を実行してください。

uvx pubship --check

上記のコマンドでは、公開済みの PyPI パッケージをインストールします。ソースをチェックアウトしたものには、まだ公開されていない変更が含まれている場合があります。uv sync の後に uv run pubship --check を実行すると、ローカル版を確認できます。

アシスタントに接続する

Claude Code

claude mcp add --transport stdio pubship -- uvx pubship

クライアントを起動するシェルで、上記の環境変数を設定してください。環境変数を変更した後は、クライアントを再起動してください。

Codex

codex mcp add pubship -- uvx pubship

Cursor と Gemini CLI

このリポジトリのクライアントマニフェストには、ローカルのサービスアカウントキーのパスとパッケージ名が記載されています。設定方法と Gemini CLI のインストールコマンドについては、クライアントのセットアップを参照してください。エージェントによるインストール支援を利用する場合は、llms-install.mdをお読みください。キーのファイルパスだけを指定し、ファイルの内容は決して指定しないでください。

汎用 MCP ハーネス

実行ファイルに uvx、引数に pubship を指定し、ローカル環境を使用する stdio サーバーを設定してください。明示的な設定が必要なクライアントの場合は、次のように設定します。

{
  "mcpServers": {
    "pubship": {
      "command": "uvx",
      "args": ["pubship"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/private/path/service-account.json",
        "GOOGLE_PLAY_PACKAGES": "com.example.app"
      }
    }
  }
}

クライアントの設定はご自身のコンピューターに保存されます。別の認証方式、有効にする API、レポート、権限の境界については、セットアップを参照してください。

何ができますか？

固定されたインベントリには、172 個のメソッド定義が含まれています。170 個には実装があり、サブスクリプションのアーカイブメソッド 1 個は Google によってサポートされておらず、無効な購入へのアクセスはプロジェクトのポリシーにより意図的に無効化されています。無効化された操作は、ローカルツールでもセルフホストツールでも呼び出せません。

• リリース、レビュー、Android vitals、および対象を絞った一括レポートを読み取ります。
• 機微データに対する個別の許可を設定して、カタログ、サブスクリプション、商品、アカウントのリソースを確認します。
• 明示的なアプリ／メソッド権限と一度限りの実行により、書き込みを準備してレビューします。
• ローカルのファイル転送に上限を設け、公開と編集のステージングを分離します。

デフォルトでは読み取りのみが有効です。任意の書き込みや機微データの読み取りには、明示的な設定が必要です。プロバイダーからのテキストは信頼できないデータとして扱ってください。データがないことは値がゼロであることを意味しません。変更を送信しても、必ずしも公開されたとは限りません。操作数は、Google でのライブ検証を主張するものではありません。

仕様と境界を確認する

• メソッドの全インベントリ
• 関連する合成テスト
• 編集のライフサイクル
• 購入操作
• アーティファクト転送
• セルフホスト設定

## 独自アカウントでのセルフホスティング

pubship-server は、お客様が管理するインフラストラクチャ向けに HTTP 実装を保持しています。PUBSHIP_SERVER_ALLOWED_EMAILS が設定されていない場合、起動を拒否します。サインインには、署名済みの Google ID トークン、検証済みの完全一致メールアドレス、nonce の紐付けが必要で、これらが確認されるまで Google の認証情報は保存されません。許可リストからアカウントを削除すると、次回の使用時に保存済みの権限が無効になります。本人確認が済んでいない従来の権限を利用するには、再接続が必要です。運営者が明示的に有効にするまで、登録は無効のままです。

プロジェクトが運営する Google 接続サービスはありません。ローカルファーストの判断とセルフホストの設定をご覧ください。

リリースノート

PubShip 0.24.2 では、ツールの説明と承認に関するヒントを改善し、ソースからのインストールとパッケージ版のインストールで同じ定義が使われていることを確認します。以前のバージョンについては変更履歴をご覧ください。ソースのバージョンは、パッケージの公開に先行する場合があります。

開発

ツール定義の品質では、TDQS 1.2 のオフラインチェック、レビュー済みのヒューリスティックな検出結果、MCP コントラクトのリグレッションテスト範囲について説明しています。オフラインのリントは、モデルによって採点される評価ではありません。

env -u GOOGLE_APPLICATION_CREDENTIALS uv sync --frozen --all-extras --group browser --group tdqs
env -u GOOGLE_APPLICATION_CREDENTIALS uv run --frozen --all-extras --group browser --group tdqs pytest
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff format --check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_catalog.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_verification.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/distribution_metadata.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv build
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/check_artifacts.py

テストでは偽のプロバイダーを使用します。ブラウザーテストには Playwright エンジンのインストールが必要です。バックアップの統合テストには age が必要です。利用できなかったプラットフォームチェックは、正直に記録してください。貢献ポリシー、リリースプロセス、セキュリティに関する報告をご覧ください。

想定される用途

PubShip は、開発者が自身の Google Play 配信作業を自動化するためのツールです。ご自身の Google 認証情報と Play Console の権限を使い、ご利用のコンピューターまたはご自身が管理するインフラストラクチャ上で動作します。PubShip プロジェクトはホスト型サービスを運営しておらず、お客様の認証情報を受け取ることもありません。ご自身または所属組織が所有するアプリと開発者アカウントにのみ使用し、Google Play Developer API の利用規約に従ってください。他者が運営するホスト型 PubShip インスタンスは、PubShip プロジェクトが提供または推奨するものではありません。

PubShip は独立したオープンソースプロジェクトであり、Google との提携、Google による推奨、または Google による後援を受けていません。Google、Google Play、Android は Google LLC の商標です。

ライセンス

PubShip は、GNU Affero General Public License v3.0 only（AGPL-3.0-only）に基づくフリーソフトウェアです。Copyright (C) 2026 Denys Vorobyov。その他のライセンス条件については、[email protected] にお問い合わせください。

商標 · サードパーティに関する通知 · ウェブサイト