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 Codex acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Codex consegue fazer de fato no Bluesky, e o que o Bluesky não deixa que ele faça.
Conectar o Hermoso ao Codex
- Um comando, e nenhuma chave.
O Codex lê o arquivo de marketplace no repositório público da Hermoso e instala as cinco skills dele (research, ad-from-brand, generate, product-photoshoot e marketing). As skills rodam o comandocodex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosohermosopelonpx, então nenhuma lista de ferramentas é carregada nas suas sessões e nada custa contexto até um comando rodar. - Entre uma vez.
Ele abre uma entrada pelo navegador e guarda uma credencial, só com acesso do dono, emnpx -y hermoso auth login~/.hermoso/config.json. Sem navegador nessa máquina, por exemplo em CI ou em um contêiner? Crie uma chave em MCP & CLI → Terminal e chaves de API e rodenpx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real de gasto, então trate-a como uma senha. - Opcional: o servidor MCP também.
Isso grava o servidor emcodex mcp add hermoso -- npx -y hermoso mcp~/.codex/config.tomle lê a mesma credencial guardada, então nenhuma chave vai no arquivo. Prefere o endpoint hospedado?codex mcp add hermoso --url https://app.hermoso.ai/mcpe depoiscodex mcp login hermosopara o login OAuth. As skills alcançam todas as ferramentas sem nenhum dos dois. - Peça algo ao Codex. “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 Codex guarda os servidores MCP em ~/.codex/config.toml, ou em .codex/config.toml de um projeto confiável, e esse arquivo é TOML, não JSON: um bloco mcpServers copiado não carrega, e uma entrada escrita à mão é [mcp_servers.hermoso] com command = "npx" e args = ["-y", "hermoso", "mcp"]. O mcp final é essencial: npx -y hermoso sem subcomando só mostra a ajuda e sai. O Codex lê marketplaces de plugin no mesmo layout .claude-plugin que o Claude Code usa, por isso um único repositório instala nos dois.
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 Codex 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
| Texto | Uma publicação no Bluesky tem limite de 300 caracteres e, à parte, de 3.000 bytes, então uma publicação cheia de emojis pode ter menos de 300 caracteres e mesmo assim ser longa demais. O limite é aplicado quando a publicação é criada ou colocada na fila, então uma publicação acima do limite é recusada enquanto você ainda está ali para corrigir, em vez de ser cortada silenciosamente no caminho. |
|---|---|
| Visibilidade | Só público. Uma publicação no Bluesky é um registro público no protocolo AT, e não existe forma não listada, privada ou de rascunho. A revisão acontece antes da chamada, nunca depois. |
| Carrossel | 2 a 4 imagens, só imagens. Quatro é o número do próprio Bluesky, vindo do léxico do protocolo AT para um embed de imagem, e uma quinta é recusada em vez de descartada. Um vídeo é outro embed, que carrega exatamente um clipe, e uma publicação tem um único embed; por isso uma publicação no Bluesky é imagens, um vídeo ou um cartão de link: uma destas três coisas. |
| Qual conta | Nenhuma, a menos que a marca tenha conectado mais de uma conta do Bluesky. Nesse caso, account indica qual, e vários sem nenhum indicado são recusados pelo nome, em vez de adivinhados. |
Experimente no Codex
Peça em linguagem comum. São frases simples, não uma DSL:
“Sem interação: para cada tag nova, publique uma atualização no Bluesky com menos de 300 caracteres e um card de link para a página do lançamento, e imprima a URL do post em JSON.”
Isso percorre get_brand → generate_image → post_to_bluesky → bluesky_post_metrics. No modo interativo, o Codex mostra a chamada antes de rodá-la. No modo não interativo não há ninguém para perguntar, o que vale a pena considerar em qualquer etapa que publique ou gaste.
Codex no Bluesky: a parte que pega
O vídeo no Bluesky tem uma armadilha que nenhuma nova tentativa resolve: o Bluesky não processa vídeo de uma conta cujo e-mail não foi confirmado. A Hermoso informa isso como uma recusa com a causa nomeada, e não como um upload que falhou, e reconectar não ajuda, porque é uma configuração da conta no Bluesky. Confirme o e-mail uma vez antes de apontar um job para vídeo. Posts de texto e de imagem não têm esse bloqueio.
Em execuções sem supervisão, prefira a CLI hermoso com --json ao manifesto completo de ferramentas. Ela custa bem menos contexto e é mais fácil de 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 Codex 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 Codex, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Telegram. Ou veja tudo o que o Codex consegue publicar.
Publique no Bluesky a partir de: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Anúncios pela linha de comando
Perguntas frequentes
O Codex consegue publicar no Bluesky?
Sim, com o plugin do Codex da Hermoso. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. O Codex passa a ter mais de 922+ ferramentas, incluindo as que publicam no Bluesky e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.
Como conecto o Bluesky ao Codex?
Duas etapas, uma vez cada. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. 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 Codex publica no Bluesky como uma chamada de ferramenta comum.
Qual é o limite de legenda do Bluesky ao publicar a partir do Codex?
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 Codex é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.
O Codex 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.
O Codex 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 Codex?
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.
Comece grátis com 30 créditos no cadastro e ganhe mais 250+ créditos. Todos os recursos estão em todos os planos.
Começar grátis → Ver preços