PubShip

PubShip

Fluxos de trabalho do Google Play para desenvolvedores, direto do seu computador. Inspecione versões, entenda avaliações e relatórios, e prepare alterações explicitamente autorizadas a partir do seu cliente MCP.

Comece localmente

Use sua própria conta de serviço com permissões para seus aplicativos no Play Console. Mantenha o JSON privado dela fora deste repositório. Conceda apenas as permissões necessárias para as operações pretendidas. Nunca cole credenciais em uma conversa com assistente.

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

Isso inicia o servidor stdio, que aguarda um cliente MCP. Para uma verificação de instalação sem credenciais:

uvx pubship --check

A versão 0.24.0 é o primeiro candidato a lançamento do PubShip. A publicação no PyPI e no MCP Registry são etapas separadas e não estão implícitas neste checkout. Até a publicação, use uv run pubship --check a partir do checkout da fonte após uv sync.

Conecte um assistente

Claude Code

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

Defina as variáveis de ambiente acima no shell que inicia seu cliente. Reinicie o cliente após alterar o ambiente dele.

Codex

codex mcp add pubship -- uvx pubship

Estrutura MCP genérica

Configure um servidor stdio com o executável uvx, o argumento pubship e seu ambiente local. Para clientes que exigem configuração explícita:

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

A configuração do cliente permanece no seu computador. Consulte configuração para modos alternativos de autenticação, APIs habilitadas, relatórios e limites de permissão.

O que ele pode fazer?

O inventário fixado contém 172 definições de métodos. 170 têm implementações, um método de arquivamento de assinatura não é suportado pelo Google, e o acesso a compras anuladas é deliberadamente desativado pela política do projeto. Operações desativadas não podem ser chamadas por ferramentas locais ou auto-hospedadas.

• Leia versões, avaliações, Android vitals e relatórios em massa com escopo definido.
• Inspecione recursos de catálogo, assinatura, produto e conta com concessões separadas de dados sensíveis.
• Prepare e revise gravações com permissões explícitas de aplicativo/método e execução de uso único.
• Mantenha transferências de arquivos locais limitadas e separe a publicação do estágio de edição.

Leituras são o padrão. Gravações opcionais e leituras sensíveis exigem configuração explícita. O texto do provedor é dado não confiável. Dados ausentes não são zero; uma alteração enviada não é necessariamente publicada. Nenhuma contagem de operações é uma afirmação de verificação ao vivo do Google.

Explore os contratos e limites

• Inventário completo de métodos
• Testes sintéticos relacionados
• Ciclo de vida de edição
• Operações de compra
• Transferências de artefatos
• Configuração de auto-hospedagem

Auto-hospedagem para suas próprias contas

pubship-server mantém a implementação HTTP para a infraestrutura que você controla. Ele se recusa a iniciar sem PUBSHIP_SERVER_ALLOWED_EMAILS. O login exige um token de ID do Google assinado, uma correspondência exata de e-mail verificada e vínculo de nonce antes que qualquer credencial do Google seja persistida. Remover uma conta da lista de permissões invalida as concessões armazenadas dela no próximo uso. Concessões legadas sem identidade verificada devem se reconectar. A inscrição permanece fechada até que o operador a habilite explicitamente.

Não há serviço conectado ao Google executado pelo projeto. Consulte a decisão local-primeiro e configuração de auto-hospedagem.

Desenvolvimento

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

Os testes usam provedores falsos. Testes de navegador exigem mecanismos Playwright instalados; testes de integração de backup exigem age. Registre verificações de plataforma indisponíveis honestamente. Consulte política de contribuição, processo de lançamento e relato de segurança.

Uso pretendido

O PubShip ajuda desenvolvedores a automatizar seu próprio trabalho de distribuição no Google Play. Ele roda no seu computador ou na infraestrutura que você controla, com suas próprias credenciais do Google e permissões do Play Console. O projeto PubShip não executa um serviço hospedado e nunca recebe suas credenciais. Use-o apenas para aplicativos e contas de desenvolvedor que você ou sua organização possuam, e siga os Termos da API Play Developer do Google. Instâncias hospedadas do PubShip executadas por terceiros não são fornecidas ou endossadas pelo projeto PubShip.

O PubShip é um projeto independente de código aberto e não é afiliado, endossado ou patrocinado pelo Google. Google, Google Play e Android são marcas registradas da Google LLC.

Licença

O PubShip é software livre sob a GNU Affero General Public License v3.0 apenas (AGPL-3.0-only). Copyright (C) 2026 Denys Vorobyov. Para outros termos de licença, entre em contato com legal@pubship.dev.

Marcas registradas · Avisos de terceiros · Site