Como Usar o goat CLI para Migrar uma Conta do Bluesky

Migrar uma conta do Bluesky para um novo handle ou provedor de hospedagem diferente pode parecer arriscado, pois é necessário transferir seus posts, seguidores e configurações sem perder dados. O goat CLI é uma ferramenta de linha de comando open-source que automatiza todo o processo de migração, lendo sua conta existente e escrevendo em uma nova conta do Bluesky. Este artigo explica como instalar o goat CLI, quais pré-requisitos são necessários e as etapas exatas para migrar sua conta com segurança. Você também aprenderá a verificar a migração e lidar com erros comuns durante a transferência.

O que o goat CLI Faz para Migração de Conta do Bluesky

O goat CLI é a interface de linha de comando oficial para o AT Protocol no qual o Bluesky é executado. Ele fornece um subcomando dedicado account migrate que copia todo o estado da sua conta de um handle do Bluesky para outro. A ferramenta transfere seus posts, reposts, curtidas, seguidores, listas e metadados do perfil. Ela não transfere mensagens diretas porque o Bluesky ainda não armazena DMs em um formato portátil.

Antes de começar, você precisa dos seguintes itens prontos:

• Node.js versão 18 ou superior instalado no Windows, macOS ou Linux.
• Duas contas do Bluesky que existam e estejam ativas. A conta de origem é a que você está deixando. A conta de destino é a nova que receberá os dados.
• Senhas de aplicativo para ambas as contas. Gere-as em Configurações do Bluesky > Senhas de aplicativo.
• Controle de DNS se você estiver migrando para um handle de domínio personalizado. Você deve adicionar um registro TXT para provar a propriedade do domínio.

Passos para Instalar o goat CLI e Migrar Sua Conta do Bluesky

O processo de migração tem três fases: instalação, execução do comando de migração e verificação de domínio, se aplicável. Siga estes passos em ordem.

Fase 1: Instalar o goat CLI na Sua Máquina

1. Abra seu terminal
   No Windows, abra o Prompt de Comando ou PowerShell como administrador. No macOS ou Linux, abra o Terminal.
2. Instale o goat globalmente
   Digite npm install -g @atproto/goat e pressione Enter. Aguarde a instalação terminar. Você verá uma mensagem de sucesso quando concluído.
3. Verifique a instalação
   Execute goat --version. A saída mostra o número da versão. Se você vir um erro, certifique-se de que o Node.js está instalado e que o npm está no PATH do sistema.

Fase 2: Executar o Comando de Migração

1. Gere senhas de aplicativo para ambas as contas
   Faça login no Bluesky pela web. Vá em Configurações > Senhas de aplicativo. Crie uma senha de aplicativo para a conta de origem e outra para a conta de destino. Copie cada senha para um arquivo de texto seguro.
2. Execute o comando migrate
   No terminal, execute o seguinte comando. Substitua os valores de exemplo pelos seus handles e senhas de aplicativo reais.

   goat account migrate --from-handle oldhandle.bsky.social --from-password SENHA_ORIGEM --to-handle newhandle.bsky.social --to-password SENHA_DESTINO

3. Aguarde a ferramenta processar
   O CLI exibirá uma barra de progresso. Primeiro ele lê todos os registros da conta de origem, depois os escreve na conta de destino. O tempo depende do número de posts e seguidores. Uma conta típica com 5000 posts leva cerca de 10 minutos.
4. Verifique a saída final
   Quando terminar, você verá uma linha de resumo dizendo “Migration complete.” A ferramenta também imprime o número total de registros transferidos.

Fase 3: Verificar Propriedade do Domínio (Apenas Domínio Personalizado)

Se o handle de destino for um domínio personalizado, como user.example.com, você deve verificar a propriedade do domínio antes que o Bluesky aceite a conta migrada. O goat CLI não faz esta etapa automaticamente.

1. Adicione um registro TXT ao seu DNS
   Faça login no seu registrador de domínio ou provedor de hospedagem DNS. Crie um registro TXT com o nome _atproto e o valor did=did:plc:SEU_DID_DESTINO. Você pode encontrar o DID na saída da migração ou executando goat account get --handle newhandle.bsky.social.
2. Aguarde a propagação do DNS
   As alterações de DNS podem levar até 48 horas, mas a maioria dos provedores atualiza em 30 minutos. Use uma ferramenta como dig _atproto.seudominio.com TXT para verificar se o registro está visível.
3. Confirme o handle no Bluesky
   Abra Configurações do Bluesky > Conta > Handle. Clique em “Eu tenho meu próprio domínio” e digite seu domínio personalizado. O Bluesky verifica o registro TXT e ativa o handle se o DID corresponder.

Problemas Comuns de Migração e Como Resolvê-los

Erro “Account not found” ao Executar o Comando

Este erro significa que o handle ou a senha de aplicativo está incorreto. Verifique se você digitou o handle exatamente, incluindo o sufixo .bsky.social ou seu domínio personalizado. Regere a senha de aplicativo se não tiver certeza de que está correta.

Migração Para em “Reading timeline” e Nunca Termina

O goat CLI pode travar se a conta de origem tiver um número muito grande de registros ou se os servidores do Bluesky estiverem sob carga. Pressione Ctrl+C para cancelar o comando. Em seguida, execute o comando novamente com a flag --resume. A ferramenta continua de onde parou, em vez de começar do zero.

Posts Aparecem Duas Vezes na Conta de Destino

Isso acontece quando você executa o comando de migração mais de uma vez sem limpar a conta de destino. A ferramenta não deduplica registros. Para corrigir, exclua a conta de destino completamente e crie uma nova antes de executar a migração novamente.

Handle de Domínio Personalizado Mostra “Não verificado” no Bluesky

O registro TXT DNS está ausente, tem um erro de digitação no valor do DID ou não foi propagado. Verifique o registro com uma ferramenta de consulta DNS. Se o registro estiver correto, aguarde 30 minutos e atualize a página de configurações de handle do Bluesky.

Migração com goat CLI vs Recriação Manual de Conta

Item	Migração com goat CLI	Recriação Manual de Conta
Tempo de configuração	10-15 minutos	Várias horas
Posts transferidos	Todos os posts, incluindo texto e links de mídia incorporados	Nenhum, a menos que copiados manualmente
Seguidores transferidos	Todas as relações de seguir	É preciso seguir cada conta novamente individualmente
Listas e feeds	Todas as listas de usuários e feeds salvos	Perdidos completamente
Risco de perda de dados	Baixo se as senhas de aplicativo estiverem corretas	Alto porque a cópia manual é propensa a erros

Agora você tem uma conta do Bluesky totalmente migrada com seus posts, seguidores e dados de perfil intactos. Para confirmar que tudo está funcionando, faça login na conta de destino no aplicativo web do Bluesky e navegue pela sua timeline e perfil. Para usuários avançados, o goat CLI também suporta o comando account export para fazer backup dos seus dados como arquivos JSON antes de migrar. Use goat account export --handle seuhandle.bsky.social --password SUA_SENHA_APP > backup.json para criar um arquivo local que você pode restaurar depois.