Hermoso

Estúdio de anúncios com IA para profissionais de marketing e agências: pesquise os anúncios que já estão vencendo no seu mercado, gere anúncios de imagem e vídeo finalizados com a identidade da sua marca e com seu produto real inserido, depois publique-os e execute as campanhas em dez plataformas de anúncios — 415 ferramentas, e diferente de outros servidores MCP de marketing, ele gera o criativo em vez de apenas agendá-lo.

Documentação

Hermoso — MCP & CLI

Gêmeo legível por máquina de https://hermoso.ai/mcp/. Gerado a partir da página publicada — não edite manualmente. Guia completo do agente: https://hermoso.ai/llms.txt · MCP: https://app.hermoso.ai/mcp

Execute todo o seu marketing a partir do seu agente

O Hermoso oferece um servidor MCP de código aberto, uma CLI e habilidades instaláveis para Claude, para que o assistente que você já usa possa executar toda a sua função de anúncios: pesquisar os anúncios vencedores no seu mercado, criar anúncios de imagem e vídeo finalizados, publicá-los e construir e ler as campanhas pagas por trás deles. Mais de 850 ferramentas em um único endpoint com OAuth, mais de 100 modelos de imagem, vídeo, voz e escrita em um único medidor de créditos, e custos exatos por renderização publicados antes de qualquer gasto.

**ClaudeGrok BotChatGPTMuseClaude CodeCursorCodexGemini CLIGrokPerplexityLe ChatClineOpenClawHermesQualquer cliente MCPTerminal

Por que agentes (e seus humanos) escolhem o Hermoso:** um único conector é uma central completa para mais de 60 modelos de imagem e vídeo — Seedance, Veo, Kling, MiniMax H3 e Gemini Omni para vídeo; Nano Banana, Imagen, Flux, Seedream e GPT Image para imagens; além de vozes premium e modelos de escrita das classes Claude, Gemini e GPT — em um único medidor de créditos, sem precisar de chaves de API ou contas por fornecedor. E além dos modelos brutos, o mesmo conector cobre o fluxo de trabalho completo de anúncios: pesquisa de concorrentes nas bibliotecas de anúncios do Meta, Google e LinkedIn, planejamento criativo, renderizações de marca finalizadas, pós-produção, pontuação, publicação e gerenciamento de campanhas. Os custos exatos de créditos por renderização são publicados em hermoso_capabilities, para que um agente bem-comportado possa te dar um número antes de gastar qualquer coisa.

O Hermoso é o MCP de marketing que executa todo o ciclo de anúncios — a maioria dos MCPs de marketing só gerencia campanhas, mas o Hermoso também cria e publica o anúncio. Conecte-o ao seu agente e pesquise, crie, publique e gerencie anúncios finalizados diretamente dos seus prompts — mais de 850 ferramentas, seu contexto de marca salvo, seus créditos. Instale pelo npm (npm install -g hermoso) — código aberto em github.com/hermoso-ai/hermoso.

Conexão em um clique: Adicionar ao Cursor · Instalar no VS Code · Claude Code: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso (Codex, Gemini CLI e Cursor: um comando cada, na configuração acima) · Claude.ai: cole https://app.hermoso.ai/mcp em Configurações → Conectores · Meta Muse: uma única mensagem de chat configura tudo, veja Hermoso no Muse. Os agentes podem descobrir automaticamente o cartão do servidor em /.well-known/mcp.json. Também listado no registro oficial de MCP (io.github.hermoso-ai/hermoso), no Smithery e no Glama.

Prefere o estúdio? Tudo o que as ferramentas fazem também está no aplicativo web — app.hermoso.ai.

Três coisas para digitar assim que estiver conectado

São frases comuns, não uma DSL. O agente escolhe as ferramentas; você aprova o gasto.

  • Pesquisar. “Quem são os três concorrentes mais próximos de oatly.com e quais são os anúncios do Meta com maior duração deles? Diga-me qual gancho se repete.” — percorre find_competitors → pull_competitor_ads → mine_angles.

  • Criar. “Crie um anúncio em vídeo UGC 9:16 para minha marca usando esse gancho, com minha foto real do produto e legendas incorporadas.” — percorre get_brand → plan_ad → render_ad e devolve a URL do mp4 finalizado.

  • Publicar. “Agende para Instagram e TikTok na terça às 9h e monte uma campanha pausada no Meta segmentada para os EUA a US$ 30/dia.” — percorre schedule_post → create_meta_campaign → create_meta_ad.

As ferramentas, por função

Todas as mais de 850 ferramentas em um único servidor com OAuth — chame qualquer uma delas do ChatGPT, Claude, Claude Desktop, Codex, Cursor, Cline, OpenClaw, Hermes, Grok Bot ou qualquer outro cliente MCP. Cada uma retorna uma URL de ativo durável ou um resultado estruturado, não prosa que o modelo precise reinterpretar.

Procurando a lista completa? Ela está na referência de ferramentas — cada ferramenta com seu esquema real de parâmetros, e o JSON legível por máquina ao lado. Essa referência é gerada: ela é construída executando o servidor MCP real e lendo tools/list de volta por um transporte real, então é exatamente a superfície que seu cliente recebe. As categorias abaixo são um tour escrito à mão, não o inventário — elas nomeiam as ferramentas que valem a pena conhecer pelo nome, e a referência é o que deve ser confiado quando os dois discordarem. Documentação completa para desenvolvedores: hermoso.ai/docs.

Pesquisa e espionagem de anúncios — find_competitors, competitor_teardown, pull_competitor_ads, research_ads, mine_angles, score_ad, check_ad_policy, analyze_video; bibliotecas de anúncios search_meta_ads, search_google_ads, search_linkedin_ads; redes sociais orgânicas search_tiktok, search_instagram, search_youtube, search_reddit, search_threads, search_threads_keyword; fetch_social_data; playbooks criativos list_skills, get_skill, save_skill.

Criar anúncios finalizados — marca draft_brand, get_brand, update_brand, use_brand, list_brands; planejar plan_ad, plan_variations; renderizar render_ad, generate_image, generate_video, generate_avatar, generate_voice, generate_text, make_template_ad (formatos de anúncio HTML nativos renderizados diretamente, então o tipo é pixel-exato), make_explainer, product_sizzle, make_thumbnail; editar e finalizar remix_static, recast_motion, reframe_video, upscale_video, dub_video, change_voice, finish_video, fix_beat, post_edit, stitch_video, clip_video; ativos list_product_photos, set_product_image, list_library, fetch_asset, upload_file.

Publicar e agendar nos seus canais — post_to_meta (Facebook / Instagram / Threads), post_to_tiktok, post_to_youtube, schedule_post (uma única fila em Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky e Telegram), list_scheduled, cancel_scheduled, manage_meta_post, update_youtube_video, upload_meta_asset, list_meta_pages, youtube_channel, tiktok_account, list_tiktok_videos. O YouTube vai além do upload: list_youtube_videos, update_youtube_video, set_youtube_thumbnail (colocar uma miniatura do Hermoso em um upload — a maior alavanca de taxa de cliques, já que o YouTube escolhe um quadro aleatório caso contrário) e youtube_video_insights (visualizações, tempo de exibição, porcentagem média de visualização, inscritos ganhos). Engajamento: list_meta_comments, reply_to_meta_comment, moderate_meta_comment, list_threads_replies, reply_to_thread, list_youtube_comments, reply_to_youtube_comment. X / Twitter: post_to_x (texto, imagem, vídeo, respostas, posts de citação, enquetes e threads inteiras — 280 caracteres em uma conta comum e até 25.000 em uma com X Premium, lidos da conta em vez de assumidos, e nunca truncados), post_x_article (o Artigo longo do próprio X, escrito em Markdown, com títulos, listas, citações, blocos de código e tabelas preservados), edit_x_post (reescrever um post já publicado, dentro da hora que o X permite), delete_x_post, x_post_metrics e x_post_insights (impressões, curtidas, reposts, respostas, citações, favoritos), x_post_insights_historical (os mesmos números de anunciante em qualquer intervalo de datas — x_post_insights só vê as últimas 28 horas), x_mentions — X é o único conector que cobra créditos por chamada de API, porque o X nos cobra por requisição, e um post com link custa aproximadamente 13× um sem; seu agente recebe o preço antes de publicar. LinkedIn: list_linkedin_pages, post_to_linkedin_page, post_to_linkedin, manage_linkedin_post, linkedin_page_analytics (desempenho orgânico da Página — seguidores e ganhos de seguidores, visualizações da Página e impressões, cliques e engajamento dos posts, para o total da Página ou por post) — a publicação no LinkedIn segmenta as Páginas da empresa que você marcar — seu perfil pessoal também está disponível, mas permanece desativado até você compartilhá-lo explicitamente. Pinterest: list_pinterest_boards, create_pinterest_board, post_to_pinterest, post_to_bluesky (Pins de imagem ou vídeo em um quadro que você escolher). O Threads vai além da publicação: list_threads_posts, list_threads_replies, reply_to_thread, hide_thread_reply, delete_thread, list_threads_mentions, threads_insights.

Ler e responder as mensagens diretas. list_inbox coloca tudo o que alguém disse à marca em uma única lista: comentários no Facebook e Instagram, respostas e menções no Threads, comentários no YouTube e Reddit, avaliações no Google, respostas no Bluesky e menções no X, além de mensagens diretas no Messenger, Instagram Direct, X, Bluesky e Telegram. reply_to_inbox_item responde qualquer uma delas por id e roteia para o canal certo para você, então o agente nunca precisa saber qual ferramenta de resposta uma plataforma usa. Por canal, quando você quiser a thread inteira em vez da linha mais recente: list_meta_conversations, read_meta_conversation, reply_to_meta_message; list_x_dms, send_x_dm; list_bluesky_convos, read_bluesky_dm, send_bluesky_dm, mark_bluesky_convo_read; list_telegram_dms, list_telegram_chats, post_to_telegram; e no WhatsApp send_whatsapp_message, send_whatsapp_broadcast, list_whatsapp_templates, create_whatsapp_template. instagram_profile transforma um @handle do Instagram no id numérico de conta que o Meta realmente quer. O que cada plataforma permite difere, e o Hermoso diz qual regra você está enfrentando em vez de deixar você descobrir por uma recusa: o Meta permite uma resposta dentro de 24 horas após a pessoa escrever, e essa janela é verificada gratuitamente antes de qualquer envio; o Telegram é uma janela contínua de 24 horas em vez de uma caixa de entrada, porque a Bot API não publica nenhum endpoint de histórico; o X mantém 30 dias de mensagens diretas e cobra por mensagem lida. O WhatsApp merece atenção separada, porque responder lá não é uma resposta de caixa de entrada: o Hermoso envia no WhatsApp por meio de send_whatsapp_message, seja um template aprovado pelo Meta para abrir uma conversa ou uma resposta de formato livre dentro da janela de atendimento ao cliente de 24 horas do Meta, e pede que você confirme o texto exato e o número exato primeiro, porque alcança um telefone real e o Meta cobra da empresa pela conversa. O Meta também não publica nenhum endpoint de histórico do WhatsApp, então uma conversa anterior à sua conexão não pode ser buscada a nenhum preço. LinkedIn e Threads não publicam nenhuma API utilizável de mensagens diretas, então nenhuma das duas é oferecida.

Enviar uma mensagem de WhatsApp, ou transmitir para a lista inteira. send_whatsapp_broadcast leva um template aprovado para uma lista de clientes, um segmento ou um lançamento, e preenche os valores de {{1}} e {{2}} de cada pessoa conforme avança, então mil pessoas recebem uma mensagem que as nomeia em vez do mesmo disparo mil vezes. O Meta não publica nenhum endpoint em massa, então é uma distribuição ritmada de uma mensagem por destinatário e roda como um trabalho em fila que você consulta em vez de uma chamada que espera: números duplicados são removidos antes de qualquer envio, um número que o Meta não pode usar é recusado pelo nome em vez de descartado silenciosamente, e cada destinatário carrega seu próprio resultado, então uma falha parcial é relatada como falha parcial e nunca como sucesso. Execute com dryRun primeiro: isso não custa nada, não envia nada e relata a contagem real de destinatários, a categoria ativa do template, o que o Meta vai cobrar e se a lista cabe no limite contínuo de 24 horas de mensagens do seu portfólio de negócios. O Meta cobra você diretamente pelas mensagens, por mensagem, nas próprias taxas por país, então uma transmissão não gasta créditos do Hermoso. Duas regras lá são do Meta, não nossas, e ambas são permanentes: uma transmissão é sempre um template aprovado, porque texto de formato livre só é legal dentro da janela de 24 horas que se abre quando essa pessoa escreve para você primeiro; e o WhatsApp exige que o destinatário tenha optado por participar, o que nada na API impõe e que continua sendo responsabilidade da empresa. Um calendário de conteúdo para todos os canais — schedule_post coloca um render finalizado na fila para um ou vários canais em um horário escolhido, com legendas por canal; list_scheduled lê o que está na fila e o que já foi publicado, com resultados por canal; cancel_scheduled puxa uma postagem de volta antes que ela seja publicada. No estúdio, a mesma fila é um calendário real — visualizações de mês, semana e lista, arraste uma postagem para reagendá-la, edite ou duplique qualquer entrada, e slots de horário fixos onde você pode soltar trabalhos. O Hermoso publica no horário definido; nada precisa ficar aberto.

Execute campanhas de anúncios Meta — create_meta_campaign, create_meta_adset, create_meta_ad, find_meta_audiences, list_meta_ads, meta_insights, meta_page_insights, meta_post_insights, update_meta_object, set_meta_campaign_status, delete_meta_object — os objetos são criados pausados, e cada gasto e exclusão exige confirmação. Antes de um orçamento ser comprometido: preview_meta_ad renderiza o anúncio real por posicionamento como um link que você pode visualizar, e estimate_meta_reach informa quantas pessoas uma especificação de segmentação realmente alcança. Públicos: list_meta_audiences e create_meta_audience criam públicos de retargeting por pixel do site, públicos de engajamento da Página e do Instagram, e públicos semelhantes — criar um não gasta nada. meta_insights detalha o desempenho por idade, gênero, posicionamento e país. A página Facebook Ads MCP explica cada ferramenta Meta e a segmentação que ela expõe.

Execute campanhas do Google Ads — create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, set_google_ads_budget, set_google_ads_bidding, set_google_ads_targeting, set_google_ads_status, find_google_ads_locations, upload_google_ads_asset, list_google_ads_campaigns, google_ads_report (GAQL) — toda a árvore é construída em uma única operação atômica e depois lida de volta do Google antes que o agente descreva o que criou. Além da árvore: create_google_ads_conversion_action e list_google_ads_conversion_actions (o que o Google conta como resultado — TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS e toda campanha Performance Max são inviáveis sem um, então o Hermoso se recusa a criá-las em uma conta que não tenha nenhum), create_google_ads_performance_max_campaign (o tipo de campanha entre superfícies do Google), add_google_ads_assets (links de site, frases de destaque e snippets estruturados, criados e anexados — um ativo não anexado não mostra nada) e google_ads_keyword_ideas (Planejador de palavras-chave: volume de pesquisa mensal real, concorrência e lances de topo de página, para que as palavras-chave sejam escolhidas com base em dados, não em suposições).

Execute anúncios no LinkedIn, Pinterest, Microsoft, X, TikTok, Snapchat, ChatGPT e Apple Search Ads — o mesmo padrão de pausado por padrão e com confirmação obrigatória em todas as outras plataformas pagas. LinkedIn: list_linkedin_ads_campaigns, linkedin_ads_report, create_linkedin_ads_campaign_group, create_linkedin_ads_campaign, create_linkedin_ads_creative, search_linkedin_ads_targeting, set_linkedin_ads_budget, set_linkedin_ads_status, delete_linkedin_ads_object. Pinterest: list_pinterest_ads_campaigns, pinterest_ads_report, create_pinterest_ads_campaign, create_pinterest_ads_ad_group, create_pinterest_ads_ad, set_pinterest_ads_budget, set_pinterest_ads_status. Microsoft Advertising (Bing): list_microsoft_ads_campaigns, microsoft_ads_report, create_microsoft_ads_campaign, create_microsoft_ads_ad_group, create_microsoft_ads_ad, add_microsoft_ads_keywords, set_microsoft_ads_budget, set_microsoft_ads_status, microsoft_ads_geo_search (resolve nomes de país, região e cidade para os IDs de localização da Microsoft que uma campanha precisa — sem locais, uma campanha da Microsoft é criada para veicular mundialmente, que é o padrão da própria Microsoft, e a leitura de volta avisa você em alto e bom som). Reddit Ads — a árvore completa da conta: list_reddit_ads_campaigns, reddit_ads_report, create_reddit_ads_campaign, create_reddit_ads_ad_group, create_reddit_ads_ad, create_reddit_ads_post (um anúncio do Reddit promove uma postagem, então o criativo é uma postagem), set_reddit_ads_status, além de planejamento gratuito com search_reddit_ads_targeting, reddit_ads_forecast e reddit_ads_bid_suggestion, rastreamento de conversões por meio de list_reddit_ads_pixels e send_reddit_ads_conversions, retargeting e públicos salvos, formulários de leads e reddit_ads_history. ChatGPT Ads — os anúncios exibidos sob uma resposta do ChatGPT, por meio da API de Anunciantes da OpenAI: list_openai_ads_campaigns, openai_ads_report, openai_ads_geo_search, create_openai_ads_campaign, create_openai_ads_ad_group, create_openai_ads_ad, update_openai_ads_object, set_openai_ads_budget, set_openai_ads_status. O ChatGPT Ads tem exatamente um formato de criativo, um cartão de texto mais imagem, e sem vídeo — então o agente extrairá um quadro estático do seu filme em vez de oferecer um anúncio em vídeo ali. X Ads — a árvore completa de postagens promovidas, ativa desde agosto de 2026: list_x_ads_accounts, list_x_ads_funding_instruments, x_ads_report, create_x_ads_campaign, create_x_ads_line_item (o nome do X para um grupo de anúncios), create_x_ads_promoted_tweet, add_x_ads_targeting, x_ads_targeting_search, x_ads_geo_search, update_x_ads_campaign, update_x_ads_line_item, set_x_ads_status, delete_x_ads_object. Um anúncio do X promove uma postagem, então o criativo é uma postagem — a mesma que post_to_x publica. TikTok Ads é uma CONEXÃO SEPARADA do conector de postagem do TikTok, e é a única plataforma que cria objetos HABILITADOS por padrão, então o Hermoso força cada nível a ficar PAUSADO, sem exceção: list_tiktok_ads_accounts, list_tiktok_ads_campaigns, list_tiktok_ads_identities, search_tiktok_ads_targeting, tiktok_ads_report, create_tiktok_ads_campaign, create_tiktok_ads_ad_group, upload_tiktok_ads_creative, create_tiktok_ads_ad, set_tiktok_ads_budget, set_tiktok_ads_status, delete_tiktok_ads_object. Snapchat Ads: list_snapchat_ads_accounts, list_snapchat_ads_campaigns, list_snapchat_ads_profiles, search_snapchat_ads_targeting, snapchat_ads_report, upload_snapchat_ads_creative, create_snapchat_ads_campaign, create_snapchat_ads_ad_squad, create_snapchat_ads_ad, set_snapchat_ads_budget, set_snapchat_ads_status, delete_snapchat_ads_object — os orçamentos são em micro-moeda (1.000.000 = uma unidade), o título do criativo tem limite de 34 caracteres e um anúncio do Snapchat aponta para um CRIATIVO, não para um ID de mídia. Três notas de acesso que valem a pena ter antes de planejar um orçamento: LinkedIn e Pinterest medem as gravações de anúncios pelo nível de API que sua própria conta de anúncios possui — relatórios e leituras são irrestritos, enquanto a criação de campanhas depende do acesso que sua conta recebeu da plataforma. Meta, Google Ads, Microsoft Advertising, Reddit Ads e ChatGPT Ads não têm esse nível. X concede acesso à API de Anúncios por CONTA DE ANÚNCIOS, não por aplicativo, então, em vez de um botão OAuth, você adiciona o usuário do X do Hermoso à sua conta de anúncios em business.x.com → Account access, e ele aparece em list_x_ads_accounts com o nível de permissão que o X concedeu.

Crie Apple Search Ads e leia-os até o termo de pesquisa — anúncios de pesquisa da App Store, de ponta a ponta. Criação: create_apple_ads_campaign, create_apple_ads_ad_group, add_apple_ads_keywords, add_apple_ads_negative_keywords, create_apple_ads_creative, create_apple_ads_ad, upload_apple_ads_asset, update_apple_ads_object, set_apple_ads_status, delete_apple_ads_object — todo objeto é criado pausado, sem exceção; habilitar é o único interruptor que ativa gastos reais e exige confirmação; e todo resumo é construído a partir de uma leitura de volta do que a Apple realmente armazenou. Os anúncios são veiculados no posicionamento da aba Pesquisa; uma campanha de resultados de pesquisa não precisa de anúncio nem criativo, porque a Apple renderiza a página do seu produto na App Store — e o Hermoso diz isso de graça, em vez de deixar a Apple rejeitar a criação. Leitura: list_apple_ads_campaigns (status, status de veiculação, orçamento diário e total, os países em que é veiculada e o motivo declarado pela própria Apple quando uma campanha não pode ser veiculada), list_apple_ads_ad_groups (lance padrão e se a Search Match da Apple está ativada), list_apple_ads_keywords (segmentação e negativa, com tipo de correspondência e lance), apple_ads_report (impressões, toques, instalações, gastos, TTR, CPT e CPA, nos níveis de campanha, grupo de anúncios, palavra-chave, termo de pesquisa ou anúncio), list_apple_ads_creatives, list_apple_ads_ads, list_apple_ads_assets, list_apple_ads_product_pages (sua listagem na App Store e quaisquer páginas de produto personalizadas, com seu conteúdo por idioma), search_apple_ads_apps e check_apple_ads_app_eligibility (quais posicionamentos, países e dispositivos seu aplicativo pode realmente anunciar — vale a pena ler antes de criar) e list_apple_ads_orgs. Não há botão OAuth para isso, porque a Apple não publica um fluxo OAuth: o Hermoso gera a chave de assinatura, você cola a parte pública em Apple Ads → Account Settings → API e cola de volta três IDs. A Apple mostra esse campo apenas para um usuário com função de API, então um Administrador de Conta convida ou alterna para um primeiro — o guia do conector Apple Search Ads explica todo o processo. Cada conexão é vinculada à única organização de Apple Ads que você escolheu ao criá-la.

Relatórios e exportação — Google Drive save_to_drive, list_drive_files, get_drive_file, update_drive_file, delete_drive_file, create_drive_folder; Sheets create_sheet, append_to_sheet, read_sheet; Docs create_doc, append_to_doc, read_doc; Microsoft OneDrive save_to_onedrive, list_onedrive_files, get_onedrive_file, update_onedrive_file, create_onedrive_folder, delete_onedrive_file. Os leads vão para seu CRM por meio do HubSpot MCP: sync_leads_to_hubspot envia leads de formulários de leads do Meta e do LinkedIn como contatos, e hubspot_deals_report relata negócios por etapa e origem.

Memória, marcas, habilidades e equipe — remember, forget, list_memory, store_get; espaços de trabalho de marca create_brand, delete_brand, use_brand, list_brands — uma agência pode assumir um novo cliente e desmontar um sem abrir o aplicativo, e os espaços de trabalho de marca são ilimitados em todos os planos; habilidades — UMA biblioteca, na qual o que costumava ser uma loja separada de “funcionários de IA” foi incorporado — save_skill, list_skills, get_skill, delete_skill; equipe invite_member, list_team, set_role, remove_member.

Conta, configurações e conectores — hermoso_capabilities (modelos de teste + custos exatos por render — chame primeiro), hermoso_credits, buy_credits, billing_status, upgrade_plan, set_auto_reload, get_job, list_jobs, report_bug, request_feature; configurações get_settings, update_settings (idioma e aparência, salvos na conta em vez de no navegador, para que um cliente somente agente não fique preso no inglês); conectores list_connectors, list_connector_accounts, set_connector_accounts (escolha exatamente quais Páginas, contas de anúncios e quadros são utilizáveis — a ferramenta relata a leitura de volta do servidor, nunca a solicitação), disconnect_connector. Conectar uma conta é uma tela de consentimento OAuth, então é a única etapa que ainda precisa de um navegador; tudo depois disso pode ser chamado pelo agente.

TODOS OS CANAIS

Um agente. Todos os canais em que você faz marketing.

Conecte uma conta uma vez e ela se torna acionável. O mesmo render finalizado pode sair organicamente, ser veiculado como mídia paga e relatar seus próprios números de volta — sem você abrir um único painel de plataforma. Funciona da mesma forma em um arquivo que você fez em outro lugar: as ferramentas de publicação, agendamento e campanha aceitam qualquer imagem ou vídeo que você enviar, então um agente pode usar esta metade sozinho.

Publique organicamente

Envie um render finalizado diretamente para as contas que você conectar — imediatamente ou na fila de um calendário de conteúdo real: visualizações de mês, semana e lista, arraste uma postagem para reagendá-la, slots de horário fixos, edite ou duplique qualquer entrada, legendas por canal, uma aprovação.

Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram

post_to_meta post_to_tiktok post_to_youtube post_to_x post_to_linkedin_page post_to_pinterest schedule_post

Execute os anúncios

Construa a árvore completa da campanha — campanha, conjunto de anúncios ou grupo de anúncios, anúncios, palavras-chave, orçamentos, lances e segmentação. Tudo é lido de volta da plataforma antes que o agente relate o que criou. Depois, as partes que a maioria das ferramentas ignora: prévias reais de anúncios Meta e estimativas de alcance antes de um orçamento ser comprometido, públicos de retargeting e semelhantes, ações de conversão do Google, Performance Max, volumes do Planejador de palavras-chave e links de site e frases de destaque criados e anexados.

Meta (Facebook & Instagram) · Google Ads · Microsoft Advertising · Reddit Ads · LinkedIn · Pinterest · X Ads · TikTok Ads · Snapchat Ads · ChatGPT Ads · Apple Search Ads

create_meta_campaign preview_meta_ad estimate_meta_reach create_google_ads_campaign google_ads_keyword_ideas create_microsoft_ads_campaign create_reddit_ads_campaign create_linkedin_ads_campaign create_pinterest_ads_campaign create_x_ads_campaign create_openai_ads_campaign

Meça e relate

Gastos, CTR, CPC e conversões no lado pago; impressões, retenção, curtidas, reposts e comentários no lado orgânico — e Google Analytics 4 para tudo o que isso alcançou no seu próprio site: sessões, usuários, conversões e receita por canal, origem/mídia, campanha ou página de destino, além de quem está no site agora. Tudo isso enviado diretamente para um Google Sheet, Doc ou pasta do Drive que sua equipe já lê.

Desempenho de campanhas · engajamento por postagem · retenção por vídeo · contagem de audiência · instalações e termos de busca do Apple Search Ads · sessões, conversões e receita do GA4 · visitantes em tempo real

meta_insights google_ads_report reddit_ads_report linkedin_ads_report pinterest_ads_report microsoft_ads_report openai_ads_report x_ads_report apple_ads_report x_post_insights_historical youtube_video_insights linkedin_page_analytics threads_insights analytics_report analytics_realtime list_analytics_properties

Responda às mensagens diretas

A pergunta que realmente converte geralmente chega como mensagem direta. Reúna todas em uma única lista, ao lado dos comentários, respostas, menções e avaliações, leia a conversa e responda no mesmo fôlego em que perguntou. Um único id volta e o Hermoso roteia a resposta para o canal certo. A janela de resposta de 24 horas do Meta é verificada gratuitamente antes de qualquer envio, e o Telegram usa uma janela contínua de 24 horas em vez de histórico, porque o Telegram não publica nenhum endpoint de histórico. O WhatsApp funciona ao contrário: o Hermoso envia por lá em vez de responder, seja uma única mensagem ou um template aprovado transmitido para uma lista inteira de clientes, com as variáveis de cada pessoa preenchidas.

Messenger · Instagram Direct · X · Bluesky · Telegram · WhatsApp (envie uma, ou transmita para uma lista)

list_inbox reply_to_inbox_item list_meta_conversations read_meta_conversation reply_to_meta_message list_x_dms send_x_dm list_bluesky_convos send_bluesky_dm list_telegram_dms send_whatsapp_message send_whatsapp_broadcast

Três coisas que valem saber de antemão. A publicação no LinkedIn tem como alvo as Páginas da empresa que você marcar — o Hermoso publica como a marca por padrão; seu perfil pessoal também está disponível, mas permanece desativado até você compartilhá-lo explicitamente. Como o X cobra por requisição de API, essas chamadas custam um pequeno número de créditos cada — e uma postagem com link custa aproximadamente 13× uma sem link, então seu agente recebe o preço antes de publicar.

A pesquisa vai além da publicação: as bibliotecas de anúncios do Meta, Google e LinkedIn, além do TikTok orgânico, Instagram, YouTube, Reddit e Threads, são todas pesquisáveis, então você pode explorar qualquer mercado para descobrir o que funciona antes de publicar qualquer coisa.

O que o agente não pode fazer sozinho

Um agente com orçamento só é útil se o raio de impacto for limitado, então a autoridade de gasto é cercada no servidor, não em um prompt:

  • Nada vai ao ar por acidente. Campanhas, conjuntos de anúncios e anúncios do Meta são criados PAUSED sem possibilidade de override pelo chamador. Toda campanha em toda plataforma é criada pausada, e os interruptores set_*_ads_status — as únicas ferramentas que ativam dinheiro real — se recusam a funcionar sem um sinalizador explícito de confirmação, e o mesmo bloqueio cobre a criação de um grupo de anúncios, anúncio ou palavra-chave habilitado do Google Ads sob um pai já habilitado, porque isso seria exibido no próximo leilão.

  • Cada renderização é cotada primeiro. hermoso_capabilities publica o custo exato em créditos de cada modelo (por duração, para vídeo), para que o agente possa precificar um plano antes de renderizá-lo.

  • Os créditos são reservados e depois liquidados. Uma renderização debita uma estimativa antes da primeira chamada ao provedor e liquida o custo exato depois — uma execução com falha reembolsa, então nada é gasto sem ser cobrado.

  • Sem gastos anônimos. Cada chamada de geração autentica e cobra uma conta real; o conector se recusa a funcionar sem uma identidade verificada.

  • Exclusões também exigem confirmação, e cada árvore de campanha é relida da plataforma de anúncios antes que o agente relate sobre ela — o resumo que você recebe é construído a partir dessa releitura, não do que foi solicitado.

Perguntas frequentes

Qual é o melhor MCP de marketing?

O Hermoso é o MCP de marketing criado para executar toda a sua função de anúncios a partir de um agente — pesquise anúncios de concorrentes, crie anúncios de imagem e vídeo finalizados, publique ou agende-os, e construa e leia as campanhas — 850+ ferramentas em um único servidor com OAuth, funcionando em ChatGPT, Claude, Cursor, Codex, Cline, OpenClaw, Hermes e Grok Bot.

Existe um MCP para executar meus anúncios do Meta?

Sim. O MCP do Hermoso cria e gerencia campanhas de anúncios do Meta (create_meta_campaign, create_meta_adset, create_meta_ad, meta_insights, set_meta_campaign_status) e publica postagens orgânicas no Facebook, Instagram e Threads — tudo a partir do seu agente.

Existe um MCP para Google Ads?

Sim. O Hermoso constrói toda a árvore do Google Ads a partir do seu agente — campanha, grupo de anúncios, anúncio de pesquisa responsivo ou de display, e palavras-chave com negativas — em uma única operação atômica, além de orçamentos, estratégia de lances, segmentação geográfica e por idioma, relatórios GAQL via google_ads_report, e um set_google_ads_status com confirmação obrigatória como o único interruptor que inicia gasto real.

Qual MCP pesquisa anúncios de concorrentes?

O MCP do Hermoso puxa anúncios de concorrentes das bibliotecas de anúncios do Meta, Google e LinkedIn, além do TikTok orgânico, Instagram, YouTube, Reddit e Threads, e analisa a estratégia deles — via find_competitors, pull_competitor_ads, competitor_teardown e research_ads.

Meu agente pode ler e responder minhas mensagens diretas?

Sim, no Messenger, Instagram Direct, X, Bluesky e Telegram, e ele envia no WhatsApp. list_inbox retorna mensagens diretas ao lado dos comentários, respostas, menções e avaliações, então "o que preciso responder hoje" é uma única chamada em todos os canais conectados; reply_to_inbox_item responde por id e escolhe o canal certo sozinho. Cada plataforma tem sua própria regra e o Hermoso a declara em vez de falhar no envio: o Meta permite uma resposta dentro de 24 horas após a pessoa escrever, o Telegram usa uma janela contínua de 24 horas em vez de histórico, o X mantém 30 dias e cobra por mensagem lida. Responder no WhatsApp não é uma resposta de caixa de entrada: passa por send_whatsapp_message como um template aprovado pelo Meta ou uma resposta de formato livre dentro da janela de atendimento ao cliente de 24 horas do Meta, e exige confirmação porque alcança um telefone real e o Meta cobra a empresa por isso. O mesmo template pode ser enviado para uma lista inteira de clientes com send_whatsapp_broadcast, que preenche as variáveis de cada pessoa, roda como um trabalho em fila e devolve um resultado por destinatário; um teste seco primeiro não custa nada e informa a contagem real de destinatários e o que o Meta cobrará. O Meta cobra você por essas mensagens diretamente, não em créditos do Hermoso, e o WhatsApp exige que o destinatário tenha optado por receber. LinkedIn e Threads não publicam uma API utilizável de mensagens diretas, então nenhum dos dois é oferecido.

O que é o servidor MCP do Hermoso?

É um servidor de Protocolo de Contexto de Modelo de código aberto que expõe a plataforma de marketing do Hermoso como 850+ ferramentas — pesquisa de concorrentes, planejamento de anúncios, geração de imagem, vídeo, avatar e voz, publicação e agendamento, gerenciamento de campanhas em Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads e Apple Search Ads, e exportação para Sheets, Docs e Drive — para que agentes como Claude Code e Cursor possam executar todo o ciclo diretamente.

Com quais agentes e clientes ele funciona?

Qualquer cliente MCP, e todo agente de codificação em um único comando. Claude Code: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso. Codex: codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso. Gemini CLI: gemini extensions install https://github.com/hermoso-ai/hermoso. Cursor, Cline, OpenClaw, Hermes e a maioria dos outros: npx skills add hermoso-ai/hermoso. Cada instalação adiciona quatro habilidades que dirigem o CLI hermoso, então nenhuma lista de ferramentas é carregada na sessão. Claude, Claude Desktop e ChatGPT colam a URL em Configurações → Conectores, o Grok Bot executa grok mcp add hermoso -- npx -y hermoso mcp, e Cursor e VS Code também podem receber o servidor MCP pelos deeplinks de um clique acima.

Posso usá-lo do Claude.ai sem instalar nada?

Sim — cole https://app.hermoso.ai/mcp em Claude → Configurações → Conectores, aprove com sua conta do Hermoso, pronto. Ou crie uma chave de API no aplicativo (MCP & CLI → Terminal & API keys) para Claude Code, Cursor e scripts.

Também existe um CLI?

Sim. npm install -g hermoso, depois hermoso auth login abre um login no navegador (loopback, como gh) e armazena uma chave exclusiva do proprietário em ~/.hermoso/config.json. O CLI cobre o ciclo principal como comandos de subprocesso com saída --json — capabilities, credits, brand, create, generate, competitors, ads, research, jobs, fetch — que é o padrão econômico em tokens para agentes de terminal: eles chamam processos externos em vez de carregar um grande manifesto de ferramentas. O mesmo pacote também serve a superfície MCP completa de 850+ ferramentas via stdio com hermoso mcp (ou npx -y hermoso mcp), então instalar o CLI não custa nada em cobertura.

Existe uma API REST?

Sim, para backends e linguagens sem cliente MCP. Aponte para https://app.hermoso.ai/v1 com uma chave bearer. /v1/posts, /v1/channels, /v1/media, /v1/credits, /v1/jobs e /v1/brands são um contrato versionado pequeno contra o qual você pode construir e manter. POST /v1/tools/{name} alcança todas as ferramentas da superfície MCP via HTTP simples, então nada fica fora do alcance — navegue por elas em GET /v1/tools. Uma renderização não precisa manter sua requisição aberta: adicione ?wait=0 e a chamada responde 202 com um id de trabalho, depois consulte GET /v1/jobs/{id} até que termine. GET /v1/jobs lista seus trabalhos e GET /v1/brands lista as marcas sobre as quais sua chave pode atuar. A especificação é gerada a partir do próprio roteador em openapi.json.

Ele gasta créditos anonimamente?

Não. Cada chamada de geração autentica e cobra uma conta real — o conector se recusa a funcionar sem identidade verificada.

Quanto custa?

Cadastre-se gratuitamente — sem cartão, e você começa com 250+ créditos grátis que podem ser ganhos. Depois disso, é um único sistema de créditos entre pesquisa, imagem e vídeo, com planos de $19, $49 e $149 por mês; todos os recursos estão disponíveis em todos os planos, e os planos diferem apenas pelos créditos mensais e pela taxa por crédito. Os custos exatos por renderização são publicados via hermoso_capabilities.

Relacionados

Usando Rovo, Dify, Zapier, Zed, uma IDE JetBrains, Devin, Windsurf ou Hermes Agent? Cada um tem sua própria página de configuração curta em conectar Hermoso por URL.

Conectado e não sabe o que perguntar? Os workflows são prompts prontos para tarefas comuns de marketing, cada um a um clique de distância do ChatGPT ou Claude.

Um agente também pode criar e pagar pela própria conta do Hermoso, sem humano em um formulário de cadastro: veja agentes que se cadastram e pagam.

Crie uma conta gratuita, conecte-a uma vez, e seu agente terá 850+ ferramentas de marketing. Prefere o estúdio visual? É o mesmo motor.

Comece grátis →

Ver no GitHub →