campaign-launcher
Skill0 starsChanged 4 months agoMITView on GitHub
Cria e publica campanhas de mídia paga do zero via Meta Ads MCP (campanha → ad set → criativo → anúncio), por um processo guiado passo a passo com portão de validação e leitura de volta a cada escrita. Use quando o usuário pedir para "subir/criar/lançar campanha ou anúncio", "publicar anúncio pelo Claude", "impulsionar post", ou disparar /subir-campanha. Diferente de ads-analyst (auditoria), performance-optimizer (monitoramento) e media-planner (planeja, não publica): aqui se CONSTRÓI e PUBLICA na conta real.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- gabchess/gtm-campaign-launchertheir own version, first seen Sep 10, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- gabchess/gtm-campaign-launcher★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository9 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ads-analystSkill
- campaign-auditSkill
- dashboard-creatorSkill
- html-mob-netlifySkill
- media-plannerSkill
- organic-auditSkill
- performance-optimizerSkill
- weekly-reportSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 84
Advantage audience: default desligado salvo pedido — targeting_automation.advantage_audience: 0 (então sem age_range, ver armadilha 4).
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Campaign Launcher — Publicação de Campanhas Guiada (Meta Ads)
Monta e publica a estrutura completa de uma campanha Meta Ads direto na conta do cliente, via MCP, por etapas com portão de validação. Cada escrita mexe em dinheiro real — nada vai ao ar sem confirmação explícita e nominal do usuário.
Esta skill é a fonte única de verdade para o fluxo de criação. Segue o protocolo de
escrita de .claude/rules/mcp-data-guide.md (§ "Ações de escrita") — não reinventar regra.
Quando usar
- Usuário quer criar/subir/lançar campanha, ad set, criativo ou anúncio novo.
- Usuário quer impulsionar um post orgânico existente do Instagram/Facebook.
Quando NÃO usar
- Auditar/diagnosticar conta existente →
ads-analyst/campaign-audit. - Monitorar ciclos recorrentes / ajustar budget de campanha no ar →
performance-optimizer. - Planejar estratégia/verba antes de existir campanha →
media-planner. - Orgânico (estratégia/criação de conteúdo) →
agente-social-media.
Regra de ouro — portão de validação
Trabalhe uma etapa por vez. Ao fim de cada etapa: apresente o que foi montado com valores exatos, faça as perguntas de validação, pare e espere aprovação. Só avance com o "sim". Se o usuário corrigir uma etapa anterior, re-trave antes de seguir.
O que NUNCA assumir (perguntar antes)
Conta/plataforma · página do Facebook + conta do Instagram que assinam o anúncio · objetivo · destino da conversão (WhatsApp/formulário/link/Messenger) · público · localização · verba/dia · moeda · mídia (imagem/vídeo e como será entregue) · copy · CTA.
⚠️ Armadilhas da API do Meta — ler ANTES de qualquer escrita
Aprendidas em produção. Ignorar qualquer uma quebra a publicação:
daily_budget/lifetime_budgetvão em CENTAVOS (minor unit), inteiros. R$50/dia =5000. Nunca em reais.- Piso de budget diário ≈
516centavos (R$5,16) — vem emmin_daily_budget_centsdeads_get_ad_accounts. Abaixo disso a API rejeita. - NUNCA enviar o campo
targeting_optimization— o Meta removeu (error_subcode 1870197). Enviar "expansion_all" ou "none" faz a chamada falhar. A expansão de segmentação Advantage não é controlável por API nesses objetivos. age_rangesó é válido comtargeting_automation.advantage_audience = 1. Se o Advantage estiver desligado (advantage_audience: 0), removaage_rangee use sóage_min/age_max(senão:error_subcode 1487079).- Editar
targetingé replace-all — envie o objeto de targeting COMPLETO (interesses, indústrias, life events, idade, geo). Mandar só um campo apaga o resto. - Editar budget ou targeting FORÇA a entidade para
PAUSED(efeito colateral da API, não é bug). Sempre confirastatus_forced_to_pausedno retorno e reative comads_activate_entitylogo em seguida. - Criativo é IMUTÁVEL. Não existe editar mídia/copy/CTA/título de um criativo publicado. Para mudar: cria criativo novo (
ads_create_creative) + anúncio novo (ads_create_ad). Por isso acerte copy/mídia ANTES de publicar. - Ativação é top-down e por entidade: campanha → ad set → anúncio. Ativar o pai NÃO ativa os filhos. Para entregar, os três níveis precisam estar
ACTIVE. - Localização por raio (pin):
geo_locations.custom_locations: [{latitude, longitude, radius, distance_unit:"kilometer"}]+location_types(["home"]= mora lá;["home","recent"]= mora + esteve lá). - Erro
INTERNALna ativação é transitório — reative a entidade de novo (costuma passar na 2ª tentativa).
Tools são deferred — carregar schema antes de chamar
Antes de cada chamada de escrita, carregue o schema com ToolSearch (select:<nome>) e
confirme os parâmetros obrigatórios reais — não chute assinatura de tool.
Etapa 0 — Pré-voo (contexto + conexão)
Objetivo: travar conta, página, IG e o briefing antes de escrever qualquer coisa.
- Identifique o cliente e carregue
clients/[slug]/profile.md(IDs de conta, KPIs, benchmarks, identidade visual). ads_get_ad_accounts→ confirme o Account ID e chequeis_ads_mcp_enabled: true,is_queryable: true,account_status: "ACTIVE",has_payment_method: true, e a moeda +min_daily_budget_cents. Se algum falhar, pare e avise.ads_get_ad_account_pages(eads_get_ig_accounts) → confirme a Página do Facebook e a conta do Instagram que vão assinar o anúncio.- Levante o briefing (perguntar o que faltar):
- Objetivo (ex.:
OUTCOME_LEADS,OUTCOME_SALES,OUTCOME_TRAFFIC,OUTCOME_ENGAGEMENT,OUTCOME_AWARENESS). - Destino da conversão: WhatsApp (qual número) · Formulário instantâneo · Site (URL) · Messenger · Ligação.
- Onde vai: campanha/ad set existente ou estrutura nova?
- Verba/dia e moeda · público · localização · mídia (imagem/vídeo + como entrega: URL pública ou caminho de arquivo local) · copy (texto principal, título, descrição) · CTA.
- Objetivo (ex.:
Portão: conta, página, IG, objetivo e destino corretos? Falta algum dado? → só avance com tudo travado.
Atalho — impulsionar post existente: se o usuário só quer promover um post do IG, pule para
ads_boost_ig_post(confirme post, público, budget/dia, duração) e vá direto ao protocolo de escrita + leitura de volta. As etapas 1–4 são para anúncio do zero.
Etapa 1 — Campanha (ads_create_campaign)
Defina: nome (padrão de nomenclatura do cliente, ex.: [WHATSAPP] [ZL] [SEM IA] [xxxx]),
objetivo, e se o budget será CBO (na campanha) ou ABO (no ad set). Se CBO,
daily_budget em centavos aqui.
Portão: apresentar nome + objetivo + nível de budget → aguardar "sim".
Etapa 2 — Ad set (ads_create_ad_set)
Defina público, localização, posicionamento, otimização e (se ABO) budget em centavos.
- Localização: país/região/cidade ou raio (pin — ver armadilha 9).
- Advantage audience: default desligado salvo pedido —
targeting_automation.advantage_audience: 0(então semage_range, ver armadilha 4). - NUNCA incluir
targeting_optimization(armadilha 3). - Idade/gênero/interesses conforme briefing. Confirme o evento/janela de otimização e o destino (ex.: WhatsApp exige a página + número; formulário exige o form id). Portão: mostrar público + geo + budget/dia (em R$) + destino → aguardar "sim".
Etapa 3 — Criativo (ads_creative_upload_image / _upload_video → ads_create_creative)
- Suba a mídia:
ads_creative_upload_imageouads_creative_upload_video(a partir da URL/arquivo informado) → guarde oimage_hash/video_id. - Monte o criativo: mídia + texto principal + título + descrição + CTA + destino (link/WhatsApp/form) + página + IG.
- Revise a copy (aplicar HSO / clareza de oferta — ver
analysis-frameworks.md§6-7). Lembre: criativo é imutável (armadilha 7) — acertar agora. Portão: exibir a copy final + descrição da mídia + CTA + destino → aguardar "sim".
Etapa 4 — Anúncio (ads_create_ad)
Crie o anúncio referenciando o creative_id dentro do ad set. Ele nasce PAUSED.
Portão: confirmar que o ad foi criado (ainda pausado, sem gastar).
Etapa 5 — Preview + confirmação final de publicação
ads_get_ad_preview→ gere a prévia e descreva/mostre ao usuário como o anúncio ficou.- Apresente o resumo consolidado: campanha (objetivo, budget/dia em R$), ad set (público, geo, destino), criativo (copy, CTA), e o custo diário total que isso adiciona à conta.
- Confirmação explícita e nominal para PUBLICAR. Se houver múltiplas entidades, o "sim" precisa cobrir o conjunto — confirme item a item ou peça o ok explícito para tudo.
Etapa 6 — Publicar + ler de volta + logar
- Ativação top-down (armadilha 8):
ads_activate_entitycampanha → ad set → anúncio.INTERNAL= transitório, retente (armadilha 10). - Ler de volta (
ads_get_ad_entities) status + budget + targeting das entidades → confirmarACTIVEnos 3 níveis e os valores aplicados. Só declare "no ar" depois disso. - Logar em
clients/[slug]/profile.md→ "Histórico de ações executadas": data, o que foi criado (IDs), budget, destino, e o resultado confirmado na leitura. - Avisar o usuário: anúncio novo entra em fase de aprendizado (~7 dias) — custo instável no início é esperado, não é anomalia.
Referência de tools (Meta Ads MCP)
| Etapa | Tool |
| Listar/validar conta | ads_get_ad_accounts |
| Página / Instagram | ads_get_ad_account_pages · ads_get_ig_accounts |
| Criar campanha | ads_create_campaign |
| Criar ad set | ads_create_ad_set |
| Subir mídia | ads_creative_upload_image · ads_creative_upload_video |
| Criar criativo | ads_create_creative |
| Criar anúncio | ads_create_ad |
| Impulsionar post IG | ads_boost_ig_post |
| Prévia | ads_get_ad_preview |
| Ativar / reativar | ads_activate_entity |
| Editar (budget/targeting) | ads_update_entity |
| Ler de volta | ads_get_ad_entities |
Proibições (de mcp-data-guide.md)
- Nunca publicar/ativar a partir de disparo agendado ou não interativo (
schedule,/loopsem humano) — sempre parar antes da escrita e aguardar turno com o usuário presente. - Nunca combinar múltiplas escritas distintas num único "sim" sem listar cada uma.
- Nunca criar entidade que gasta sem valor de budget explícito confirmado.
Troubleshooting (erros reais)
| Erro / sintoma | Causa | Solução |
1870197 "targeting_optimization … removed" | Enviou o campo removido | Remover targeting_optimization do payload |
1487079 "targeting_automation must be enabled to use age_range" | age_range com Advantage off | Remover age_range; usar só age_min/age_max |
Entidade voltou PAUSED após editar budget/targeting | Efeito colateral da API | ads_activate_entity + ler de volta |
INTERNAL na ativação | Transitório do Meta | Retentar a ativação |
| Budget rejeitado | Valor em reais, não centavos, ou < piso | Converter p/ centavos; respeitar min_daily_budget_cents |
| "Não consigo editar o criativo" | Criativo é imutável | Criar criativo + anúncio novos |
| Conta não publica | is_ads_mcp_enabled=false, sem pagamento, ou DISABLED | Checar retorno de ads_get_ad_accounts; resolver no Ads Manager |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

