PubShip

PubShip

Alur kerja developer Google Play, dari komputer Anda sendiri. Periksa rilis, pahami ulasan dan laporan, serta siapkan perubahan yang diotorisasi secara eksplisit dari klien MCP Anda.

Mulai secara lokal

Gunakan akun layanan Anda sendiri dengan izin untuk aplikasi Anda di Play Console. Simpan JSON privatnya di luar repositori ini. Berikan hanya izin yang diperlukan untuk operasi yang Anda maksudkan. Jangan pernah menempelkan kredensial ke dalam percakapan asisten.

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

Ini memulai server stdio, yang menunggu klien MCP. Untuk pemeriksaan instalasi tanpa kredensial:

uvx pubship --check

Versi 0.24.0 adalah kandidat rilis pertama PubShip. Publikasi PyPI dan MCP Registry adalah langkah terpisah dan tidak tersirat oleh checkout ini. Sampai dipublikasikan, gunakan uv run pubship --check dari checkout sumber setelah uv sync.

Hubungkan asisten

Claude Code

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

Atur variabel lingkungan di atas di shell yang meluncurkan klien Anda. Mulai ulang klien setelah mengubah lingkungannya.

Codex

codex mcp add pubship -- uvx pubship

Kerangka kerja MCP generik

Konfigurasikan server stdio dengan executable uvx, argumen pubship, dan lingkungan lokal Anda. Untuk klien yang memerlukan konfigurasi eksplisit:

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

Konfigurasi klien tetap berada di komputer Anda. Konsultasikan setup untuk mode autentikasi alternatif, API yang diaktifkan, laporan, dan batasan izin.

Apa yang bisa dilakukannya?

Inventaris yang disematkan berisi 172 definisi metode. 170 memiliki implementasi, satu metode arsip langganan tidak didukung oleh Google, dan akses pembelian yang dibatalkan sengaja dinonaktifkan oleh kebijakan proyek. Operasi yang dinonaktifkan tidak dapat dipanggil melalui alat lokal atau self-host.

• Baca rilis, ulasan, Android vitals, dan laporan massal yang dibatasi cakupannya.
• Periksa sumber daya katalog, langganan, produk, dan akun dengan hibah data sensitif terpisah.
• Siapkan dan tinjau penulisan dengan izin aplikasi/metode eksplisit dan eksekusi sekali pakai.
• Jaga transfer file lokal tetap terbatas dan pisahkan publikasi dari pementasan edit.

Pembacaan adalah default. Penulisan opsional dan pembacaan sensitif memerlukan konfigurasi eksplisit. Teks penyedia adalah data yang tidak tepercaya. Data yang hilang bukan nol; perubahan yang diajukan belum tentu dipublikasikan. Tidak ada jumlah operasi yang merupakan klaim verifikasi Google langsung.

Jelajahi kontrak dan batasan

• Inventaris metode lengkap
• Tes sintetis terkait
• Siklus hidup edit
• Operasi pembelian
• Transfer artefak
• Konfigurasi self-host

Self-hosting untuk akun Anda sendiri

pubship-server mempertahankan implementasi HTTP untuk infrastruktur yang Anda kendalikan. Ia menolak untuk memulai tanpa PUBSHIP_SERVER_ALLOWED_EMAILS. Masuk memerlukan token ID Google yang ditandatangani, kecocokan email persis yang terverifikasi, dan pengikatan nonce sebelum kredensial Google apa pun disimpan. Menghapus akun dari daftar izin membatalkan hibah tersimpannya pada penggunaan berikutnya. Hibah lama tanpa identitas terverifikasi harus terhubung kembali. Pendaftaran tetap tertutup sampai operator mengaktifkannya secara eksplisit.

Tidak ada layanan terhubung Google yang dijalankan proyek. Lihat keputusan local-first dan setup self-host.

Pengembangan

env -u GOOGLE_APPLICATION_CREDENTIALS uv sync --all-extras --group browser
env -u GOOGLE_APPLICATION_CREDENTIALS uv run 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

Tes menggunakan penyedia palsu. Tes browser memerlukan mesin Playwright yang terinstal; tes integrasi cadangan memerlukan age. Catat pemeriksaan platform yang tidak tersedia dengan jujur. Lihat kebijakan kontribusi, proses rilis, dan pelaporan keamanan.

Penggunaan yang dimaksudkan

PubShip membantu developer mengotomatiskan pekerjaan distribusi Google Play mereka sendiri. Ia berjalan di komputer Anda atau di infrastruktur yang Anda kendalikan, dengan kredensial Google dan izin Play Console Anda sendiri. Proyek PubShip tidak menjalankan layanan yang dihosting dan tidak pernah menerima kredensial Anda. Gunakan hanya untuk aplikasi dan akun developer yang Anda atau organisasi Anda miliki, dan ikuti Ketentuan API Play Developer Google. Instans PubShip yang dihosting oleh pihak lain tidak disediakan atau didukung oleh proyek PubShip.

PubShip adalah proyek sumber terbuka independen dan tidak berafiliasi dengan, didukung oleh, atau disponsori oleh Google. Google, Google Play, dan Android adalah merek dagang Google LLC.

Lisensi

PubShip adalah perangkat lunak bebas di bawah GNU Affero General Public License v3.0 saja (AGPL-3.0-only). Hak cipta (C) 2026 Denys Vorobyov. Untuk ketentuan lisensi lainnya, hubungi legal@pubship.dev.

Merek dagang · Pemberitahuan pihak ketiga · Situs web