Código aberto · MITv0.1.0

Publique lançamentos de apps pelo terminal

O searvia é uma ferramenta de linha de comando de código aberto, escrita em TypeScript, para lançamentos na App Store e no Google Play. Ela mantém as fichas das lojas em arquivos simples junto do seu código, verifica tudo antes de publicar e envia o lançamento completo para análise com um único comando.

Executar sem instalar

npx searvia --help

Requer Node.js 20 ou superior. Não precisa de conta; usa sua própria chave de API do App Store Connect e sua conta de serviço do Google Play.

Ver o repositório no GitHub

O que ela faz

Baixar e enviar fichas das lojas
Baixe nome, subtítulo, palavras-chave, descrições e notas da versão de cada idioma das duas lojas em pastas compatíveis com o fastlane, edite no seu editor e envie de volta.
Auditoria ASO offline
Verifica cada idioma sem chamadas de rede: o campo de palavras-chave de 100 bytes, palavras repetidas que já estão no nome e no subtítulo, limites de caracteres e campos vazios.
Envio de capturas de tela
Envia capturas de tela e prévias do app por idioma e dispositivo, confere antes os tamanhos exatos em pixels da Apple e do Google e mantém a ordem.
Envio de builds
Envia o Android App Bundle para uma faixa do Play e o build de iOS para o App Store Connect, e aguarda até o processamento terminar.
Lançamento para análise com um comando
Cria a versão na App Store, anexa o build, responde à conformidade de exportação e envia para análise, ou promove uma versão do Play com lançamento em etapas.
Conexão opcional com o Searvia
Com uma chave de API do Searvia, ela adiciona posições de palavras-chave, popularidade e sugestões de metadados com IA à auditoria, pela mesma API e pelas mesmas ferramentas MCP do app Searvia.

Comandos

terminal

npx searvia init              # detects fastlane folders and keys
npx searvia pull              # store text → ./fastlane/metadata
npx searvia audit             # offline ASO checks, no keys needed
npx searvia push              # shows the changes; add --yes to apply
npx searvia screenshots upload --yes
npx searvia build upload --ipa App.ipa --yes
npx searvia release --platform ios --ipa App.ipa --yes

Todo comando que grava em uma loja mostra as alterações primeiro e só as aplica com --yes. Execute npx searvia <command> --help para ver todas as opções.

Arquivos que você já conhece

Pastas compatíveis com o fastlane

fastlane/metadata/
  en-US/
    name.txt
    subtitle.txt
    keywords.txt
    description.txt
    release_notes.txt
  android/en-US/
    title.txt
    short_description.txt
    full_description.txt
    changelogs/default.txt

Use no CI

As chaves vêm de variáveis de ambiente, então os mesmos comandos funcionam no GitHub Actions, GitLab CI ou Bitrise. Uma auditoria com falha interrompe o pipeline antes que qualquer coisa chegue à loja.

.github/workflows/release.yml

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20 }
      - run: npx searvia audit
      - run: npx searvia push
        env:
          ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
          ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
          ASC_PRIVATE_KEY: ${{ secrets.ASC_PRIVATE_KEY }}
          PLAY_SERVICE_ACCOUNT: ${{ secrets.PLAY_SERVICE_ACCOUNT }}
          SEARVIA_API_KEY: ${{ secrets.SEARVIA_API_KEY }}  # optional

Prefere uma interface?

O mesmo fluxo de lançamento está disponível no app Searvia: checklist em tempo real para as duas lojas, envio de capturas de tela, seleção de build e envio para análise, com notificações quando o status da análise da Apple mudar.

Acompanhe o repositório Começar grátis