Publicar no Bluesky a partir do Claude Code

Hermoso é um servidor MCP de marketing: 922+ ferramentas em um endpoint único com OAuth, que permitem a um agente pesquisar os anúncios que já rodam em um mercado, gerar anúncios finalizados em imagem e vídeo, publicá-los e montar as campanhas pagas por trás deles. O Claude Code acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Claude Code consegue fazer de fato no Bluesky, e o que o Bluesky não deixa que ele faça.

Conectar o Hermoso ao Claude Code

1. Um comando, e sem chave.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Já está dentro de uma sessão? Digite /plugin marketplace add hermoso-ai/hermoso, depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso (research, ad-from-brand, generate, product-photoshoot e marketing) que rodam o comando hermoso pelo npx, então nenhuma lista de ferramentas é carregada nas suas sessões, e nada custa contexto até ser executado.
2. Entre uma vez.

   npx -y hermoso auth login

   Ele abre um login pelo navegador em loopback, do mesmo jeito que o gh faz, e guarda uma credencial de acesso exclusivo do dono em ~/.hermoso/config.json. O Claude Code roda isso por você na primeira vez que precisar da Hermoso. Sem navegador nessa máquina, por exemplo em CI, num servidor remoto ou num contêiner? Crie uma chave em MCP & CLI → Terminal & API keys e rode npx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real para gastar, então trate-a como uma senha.
3. Opcional: o servidor MCP também. Se você quiser também as ferramentas da Hermoso na lista de ferramentas do próprio Claude Code, rode claude mcp add hermoso -- npx -y hermoso mcp depois de entrar. Ele lê a mesma credencial guardada, então nenhuma chave vai para o .claude.json. As skills alcançam todas as ferramentas sem ele.
4. Peça algo ao Claude Code. “Puxe os anúncios mais duradouros dos meus três concorrentes mais próximos e refaça o melhor gancho em um vídeo 9:16”, ou “publique este render no canal”. O agente escolhe as ferramentas; você aprova o gasto.

O plugin e o servidor MCP opcional acessam as mesmas ferramentas e a mesma conta. A diferença é o contexto: uma lista de ferramentas é carregada em cada sessão antes de você digitar qualquer coisa, enquanto as skills não custam nada até que um comando seja executado.

Depois conecte o próprio Bluesky, uma vez, em Configurações → Conectores na Hermoso, com o seu identificador e uma senha de aplicativo do Bluesky. Não há tela de consentimento: a senha de aplicativo é criada nas configurações do próprio Bluesky, e pode ser revogada por lá sem tocar na sua senha real.

As ferramentas do Bluesky que o Claude Code recebe

• post_to_bluesky: publica uma postagem como a conta conectada: até 300 caracteres, com até quatro imagens e texto alternativo, ou um vídeo MP4 com legendas opcionais. Um link sem mídia ganha um cartão de pré-visualização, que a Hermoso gera porque o Bluesky não busca um.
• schedule_post: coloca na fila do calendário que todos os outros canais compartilham, com o limite de 300 caracteres verificado quando entra na fila, e não quando é disparado.
• list_bluesky_posts: as publicações recentes da própria conta, com os seus AT-URIs e contagens ao vivo, marcando os reposts para que a publicação de outra pessoa nunca seja lida como sua.
• bluesky_post_metrics / bluesky_account: curtidas, reposts, respostas, citações e marcadores por publicação, além de seguidores, seguindo e número de publicações da sua conta ou de qualquer conta pública.
• list_bluesky_convos / read_bluesky_dm / send_bluesky_dm: lê e responde mensagens diretas, incluindo solicitações de mensagem de pessoas que a conta não segue.
• manage_bluesky_convo / react_to_bluesky_dm / mark_bluesky_convo_read: aceita uma solicitação, silencia, bloqueia ou sai de uma conversa, reage com um emoji e zera as contagens de não lidas.
• delete_bluesky_post: remove uma publicação, depois de uma primeira chamada que não exclui nada e lê de volta o que seria removido.

O Bluesky conecta com uma senha de aplicativo, e não com uma tela de login: crie uma nas configurações do Bluesky e cole-a junto com o identificador em Configurações → Conectores. Marque o acesso a mensagens diretas ao criá-la, ou as ferramentas de DM vão avisar que a senha não pode conversar, o que é uma propriedade da senha e não uma conexão quebrada. Mais duas regras do Bluesky que a Hermoso confere antes de enviar: um vídeo exige um e-mail confirmado na conta do Bluesky, e um cartão de link e uma imagem não podem dividir a mesma publicação. Publicar não consome créditos, porque o Bluesky não cobra nada por chamada.

Limites do Bluesky que vale conhecer antes de automatizar qualquer coisa

Experimente no Claude Code

Peça em linguagem comum. São frases simples, não uma DSL:

“Publique a nota de lançamento de ./notes/bluesky.txt no Bluesky com as duas capturas de ./assets como imagens com texto alternativo, e acrescente o AT-URI do post a ./out/posts.log.”

Isso percorre get_brand → generate_image → post_to_bluesky → bluesky_post_metrics. O Claude Code pede confirmação antes de rodar uma ferramenta, e a transcrição fica ali no terminal, então cada etapa de publicação é uma linha que você lê antes de apertar y.

Claude Code no Bluesky: a parte que pega

Guarde o AT-URI. bluesky_post_metrics e delete_bluesky_post tratam o post pelo URI at://, e não pelo link do bsky.app; um script que guardou só o link web precisa passar por list_bluesky_posts para achá-lo. Os números que você lê depois são apenas contagens: curtidas, reposts, respostas, citações e salvamentos. O Bluesky não publica impressões em nenhum lugar do protocolo, então não há taxa de engajamento para calcular, e um relatório que mostrasse uma seria inventado.

O plugin não traz manifesto de ferramentas, o que importa mais em uma execução longa e sem supervisão: o agente chama o comando hermoso a cada etapa, e --json em qualquer comando lhe dá uma saída de máquina para validar.

Pesquise o Bluesky antes de publicar

Não existe biblioteca de anúncios do Bluesky nem busca no Bluesky na Hermoso, então a pesquisa de concorrentes ali se resume a uma coisa honesta: bluesky_account lê seguidores, seguindo e número de publicações de qualquer conta pública, o que basta para dimensionar um concorrente e acompanhá-lo semana a semana. Todo o restante da área de pesquisa (as bibliotecas de anúncios da Meta, do Google e do LinkedIn, e o TikTok, Instagram, YouTube, Reddit e Threads orgânicos) segue igual.

A metade paga

A Hermoso não tem produto de anúncios no Bluesky, e não damos a entender que tenha. Aqui o Bluesky é orgânico: publicar, agendar, ler, responder e medir. As ferramentas pagas cobrem Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads.

O que o Claude Code não consegue fazer sozinho

Um agente com orçamento só é útil se o raio de impacto for limitado, então a cerca fica no servidor, e não em um prompt. Toda campanha, conjunto de anúncios, grupo de anúncios e anúncio é criado pausado, e as trocas de status que ativam dinheiro real se recusam a rodar sem uma flag de confirmação explícita. Cada render é cotado antes (hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer gasto). Os créditos são reservados antes da primeira chamada ao provedor e acertados pelo custo exato depois, então uma falha no envio devolve o valor em vez de deixar você cobrado por nada. As exclusões também exigem confirmação, e cada árvore de campanha é relida da plataforma de anúncios antes que o seu agente diga o que construiu.

Um passo fica propositalmente com você: criar a senha de aplicativo do Bluesky e conectá-la uma vez. Tudo depois disso é uma chamada de ferramenta.

O resto da matriz

Pelo Claude Code, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Telegram. Ou veja tudo o que o Claude Code consegue publicar.

Publique no Bluesky a partir de: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Marketing com Claude Code

Perguntas frequentes

O Claude Code consegue publicar no Bluesky?

Sim, com o plugin do Claude Code da Hermoso. Um comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dentro de uma sessão, /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso que acionam a CLI hermoso, então nenhuma lista de ferramentas é carregada nas suas sessões. Entre uma vez com npx -y hermoso auth login, que abre o navegador e guarda a credencial por conta própria, então não há chave para criar nem para colar. O Claude Code então tem 922+ ferramentas, incluindo as que publicam no Bluesky, além das que pesquisam os anúncios que já estão rodando no seu mercado e renderizam o criativo em primeiro lugar.

Como conecto o Bluesky ao Claude Code?

Duas etapas, uma vez cada. Um comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dentro de uma sessão, /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso que acionam a CLI hermoso, então nenhuma lista de ferramentas é carregada nas suas sessões. Entre uma vez com npx -y hermoso auth login, que abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Depois crie uma senha de app nas configurações do Bluesky (marque o acesso a mensagens diretas se quiser as ferramentas de DM) e cole-a junto com o seu handle em Configurações → Conectores na Hermoso. Depois disso o Claude Code publica no Bluesky como uma chamada de ferramenta comum.

O Claude Code consegue publicar no Bluesky de forma privada ou como rascunho?

Não. Uma publicação no Bluesky é um registro público no protocolo AT, sem forma não listada, privada ou de rascunho, então a revisão deve acontecer antes da chamada. A Hermoso recusa uma visibilidade que o Bluesky não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.

Quanto custa publicar no Bluesky a partir do Claude Code?

Publicar no Bluesky não consome créditos, porque o Bluesky não cobra nada por chamada. Os créditos são gastos na geração do criativo. Os planos são $29, $69 e $149 por mês, para 1.200, 3.000 e 7.000 créditos, e todos os recursos estão em todos os planos, incluindo o Grátis. A única exceção é o SSO empresarial.

Qual é o limite de legenda do Bluesky ao publicar a partir do Claude Code?

Uma publicação no Bluesky tem limite de 300 caracteres e de 3.000 bytes, então uma publicação cheia de emojis pode ter menos de 300 caracteres e mesmo assim ser recusada. A Hermoso diz qual limite se aplicou e por quanto. Ela aplica o limite quando a publicação é criada ou colocada na fila, então o Claude Code é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.

O Claude Code consegue agendar um post no Bluesky para depois?

Sim. O schedule_post coloca o post na fila de uma agenda única compartilhada com todos os outros canais, com uma legenda por canal se o texto precisar ser diferente, e o list_scheduled e o cancel_scheduled leem e retiram o post. O Bluesky é um dos onze canais que entram na fila.