Como Criar um Rotulador Personalizado para Sua Própria Comunidade no Bluesky

Os rotuladores do Bluesky permitem que gerentes de comunidade e moderadores adicionem tags a posts ou contas sem excluir conteúdo. Um rotulador personalizado pode marcar posts como enganosos, sinalizar contas como confiáveis ou adicionar contexto às discussões dentro da sua comunidade. Este artigo explica como um rotulador funciona, o que você precisa para configurar um e as etapas exatas para implantar seu próprio serviço de rotulador. Você aprenderá a configurar rótulos de moderação, publicar um feed de rotulador e evitar erros comuns de configuração.

O que um Rotulador Bluesky Faz e Por Que Você Precisa de Um

Um rotulador no Bluesky é um serviço que anexa rótulos a posts, contas ou feeds. Rótulos são tags simples como enganoso, spam, confiável ou qualquer string personalizada que você definir. Quando um rótulo é aplicado, o cliente Bluesky mostra um selo visual ou oculta o conteúdo com base nas configurações de moderação do usuário.

Você precisa de um rotulador se sua comunidade tem mais de algumas centenas de membros e você deseja moderação consistente sem excluir posts. Rotuladores permitem marcar conteúdo sem removê-lo, dando aos membros a escolha de ver ou ocultar itens rotulados. O rotulador funciona como um serviço separado, independente da sua conta pessoal, para que vários moderadores possam gerenciar rótulos por meio de uma ferramenta compartilhada.

Antes de construir um rotulador, você precisa de três coisas:

• Uma conta Bluesky com um handle que será o “dono” do rotulador. Pode ser uma conta dedicada da comunidade.
• Um servidor ou instância em nuvem onde o serviço de rotulador será executado. Uma máquina virtual pequena com 1 GB de RAM e um endereço IP público é suficiente para a maioria das comunidades.
• Familiaridade básica com linha de comando, Docker ou Node.js. O kit inicial lida com a maior parte da complexidade, mas você precisa editar arquivos de configuração e iniciar o serviço.

Etapas para Implantar um Rotulador Bluesky Personalizado

Siga estas etapas para configurar um rotulador para sua comunidade. As instruções usam o kit inicial oficial de rotulador Bluesky disponível no GitHub. Todos os comandos assumem um servidor Linux com Docker instalado.

1. Crie uma Conta Bluesky Dedicada para o Rotulador
   Cadastre uma nova conta Bluesky. Use um handle que represente sua comunidade, como @mods.suacomunidade.bsky.social. Esta conta será a identidade do rotulador. Não use sua conta pessoal para o rotulador.
2. Gere uma Chave de API para a Conta do Rotulador
   Faça login na conta do rotulador no Bluesky. Vá em Configurações > Senhas de aplicativo. Clique em Adicionar senha de aplicativo. Nomeie como servico-rotulador e copie a senha gerada. Armazene-a com segurança.
3. Clone o Kit Inicial do Rotulador
   No seu servidor, execute: git clone https://github.com/bluesky-social/labeler-starter-kit.git. Em seguida, entre no diretório: cd labeler-starter-kit.
4. Configure as Definições do Rotulador
   Copie o arquivo de configuração de exemplo: cp config.example.yaml config.yaml. Abra config.yaml em um editor de texto. Defina os seguintes valores:

   – handle: O handle da sua conta de rotulador (ex.: mods.suacomunidade.bsky.social).
   – password: A senha de aplicativo gerada na etapa 2.
   – service: Defina como https://bsky.social para a rede principal do Bluesky.
   – labels: Defina os rótulos que sua comunidade usará. Cada rótulo precisa de um rkey (um ID curto), um displayName e uma description. Exemplo:

   labels:
     - rkey: enganoso
       displayName: Enganoso
       description: Conteúdo que contém informações falsas ou enganosas
     - rkey: confiavel
       displayName: Fonte Confiável
       description: Membro verificado da comunidade ou fonte confiável

5. Construa e Inicie o Serviço de Rotulador
   Execute docker compose up -d. O Docker construirá a imagem do rotulador e iniciará o serviço. O rotulador escuta na porta 2583 por padrão. Verifique se o serviço está em execução com docker compose ps.
6. Registre o Rotulador no Bluesky
   Assim que o serviço estiver em execução, ele precisa se anunciar para a rede Bluesky. Execute: docker compose exec labeler node register.js. Este script envia uma solicitação de registro ao relay do Bluesky. Você deve ver uma mensagem de sucesso com o DID do seu rotulador.
7. Conceda Acesso de Moderador à Sua Equipe
   Apenas a conta do rotulador pode aplicar rótulos por padrão. Para permitir que outros moderadores da comunidade usem o rotulador, você precisa adicionar seus DIDs à configuração. Em config.yaml, adicione uma lista moderators:

   moderators:
     - did:plc:xxxxxxxxxxxxx
     - did:plc:yyyyyyyyyyyyy

   Encontre o DID de um usuário visitando o perfil dele no Bluesky e observando a URL: bsky.app/profile/did:plc:xxxxxxxxxxxxx. Reinicie o serviço com docker compose restart após adicionar moderadores.

8. Teste o Rotulador
   Abra o aplicativo Bluesky. Pesquise pelo handle da sua conta de rotulador. Você deve ver um selo de rotulador no perfil. Vá para qualquer post, clique no menu de três pontos e selecione Denunciar ou rotular. Se você for um moderador, verá seus rótulos personalizados na lista. Aplique um e verifique se o post exibe o selo do rótulo.

Erros Comuns e Limitações ao Construir um Rotulador

O serviço de rotulador falha ao registrar no Bluesky

Se a etapa de registro falhar, verifique se o firewall do seu servidor permite conexões de entrada na porta 2583. Verifique também se o handle e a password em config.yaml estão corretos. A senha de aplicativo deve ser gerada a partir da conta do rotulador, não da sua conta pessoal.

Rótulos personalizados não aparecem no cliente Bluesky

O Bluesky armazena em cache as definições de rótulos por até 30 minutos. Após adicionar novos rótulos ao config.yaml, reinicie o serviço e aguarde. Confirme também que os rótulos estão definidos sob a chave labels no arquivo YAML e que a indentação do YAML está correta. Use um validador YAML online se necessário.

Moderadores não conseguem ver ou aplicar rótulos

Apenas DIDs listados na seção moderators do config.yaml podem aplicar rótulos através do rotulador. Certifique-se de que você adicionou o DID correto e reiniciou o serviço. Verifique também se o moderador está logado no Bluesky com a conta que corresponde ao DID.

O rotulador para de funcionar após uma atualização do Bluesky

O AT Protocol evolui com frequência. Acompanhe o blog de desenvolvedores do Bluesky e o repositório do kit inicial do rotulador para mudanças que quebram a compatibilidade. Atualize seu clone local com git pull e reconstrua a imagem Docker com docker compose up -d --build.

Opções de Rotulador: Auto-hospedado vs Serviços Gerenciados

Item	Rotulador Auto-hospedado	Serviço de Rotulador Gerenciado
Esforço de configuração	Requer servidor, Docker e habilidades de CLI	Mínimo; fornecido por terceiros
Custo	Apenas taxas de hospedagem do servidor	Assinatura mensal ou taxas por rótulo
Personalização	Controle total sobre definições e lógica dos rótulos	Limitado a tipos de rótulo predefinidos
Privacidade de dados	Todos os dados de rótulos ficam no seu servidor	Os dados de rótulos são processados pelo provedor de serviços
Manutenção	Você cuida de atualizações, backups e disponibilidade	O provedor cuida da manutenção

Agora você pode implantar um rotulador Bluesky personalizado para sua comunidade e dar aos seus moderadores uma ferramenta compartilhada para marcar conteúdo sem excluí-lo. Após o rotulador estar em execução, explore o painel de moderação do rotulador em http://seu-ip-do-servidor:2583 para ver os rótulos aplicados em tempo real. Para uso avançado, veja o recurso de webhook do rotulador, que permite acionar aplicações automáticas de rótulos com base em fontes de dados externas, como listas de bloqueio ou relatórios da comunidade.