agentleFS
lucaspaesbrazil-lablucaspaesbrazil-lab/agencia-digital-showcase/.claude/skills/campaign-launcher/SKILL.md

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

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    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.

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
  1. Very specific:

    Advantage audience: default desligado salvo pedido — targeting_automation.advantage_audience: 0 (então sem age_range, ver armadilha 4).

    line 84

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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:

  1. daily_budget/lifetime_budget vão em CENTAVOS (minor unit), inteiros. R$50/dia = 5000. Nunca em reais.
  2. Piso de budget diário ≈ 516 centavos (R$5,16) — vem em min_daily_budget_cents de ads_get_ad_accounts. Abaixo disso a API rejeita.
  3. 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.
  4. age_range só é válido com targeting_automation.advantage_audience = 1. Se o Advantage estiver desligado (advantage_audience: 0), remova age_range e use só age_min/age_max (senão: error_subcode 1487079).
  5. Editar targeting é replace-all — envie o objeto de targeting COMPLETO (interesses, indústrias, life events, idade, geo). Mandar só um campo apaga o resto.
  6. Editar budget ou targeting FORÇA a entidade para PAUSED (efeito colateral da API, não é bug). Sempre confira status_forced_to_paused no retorno e reative com ads_activate_entity logo em seguida.
  7. 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.
  8. 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.
  9. 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á).
  10. Erro INTERNAL na 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.

  1. Identifique o cliente e carregue clients/[slug]/profile.md (IDs de conta, KPIs, benchmarks, identidade visual).
  2. ads_get_ad_accounts → confirme o Account ID e cheque is_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.
  3. ads_get_ad_account_pages (e ads_get_ig_accounts) → confirme a Página do Facebook e a conta do Instagram que vão assinar o anúncio.
  4. 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.

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 sem age_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)

  1. Suba a mídia: ads_creative_upload_image ou ads_creative_upload_video (a partir da URL/arquivo informado) → guarde o image_hash / video_id.
  2. Monte o criativo: mídia + texto principal + título + descrição + CTA + destino (link/WhatsApp/form) + página + IG.
  3. 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

  1. ads_get_ad_preview → gere a prévia e descreva/mostre ao usuário como o anúncio ficou.
  2. 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.
  3. 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

  1. Ativação top-down (armadilha 8): ads_activate_entity campanha → ad set → anúncio. INTERNAL = transitório, retente (armadilha 10).
  2. Ler de volta (ads_get_ad_entities) status + budget + targeting das entidades → confirmar ACTIVE nos 3 níveis e os valores aplicados. Só declare "no ar" depois disso.
  3. 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.
  4. 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)

EtapaTool
Listar/validar contaads_get_ad_accounts
Página / Instagramads_get_ad_account_pages · ads_get_ig_accounts
Criar campanhaads_create_campaign
Criar ad setads_create_ad_set
Subir mídiaads_creative_upload_image · ads_creative_upload_video
Criar criativoads_create_creative
Criar anúncioads_create_ad
Impulsionar post IGads_boost_ig_post
Préviaads_get_ad_preview
Ativar / reativarads_activate_entity
Editar (budget/targeting)ads_update_entity
Ler de voltaads_get_ad_entities

Proibições (de mcp-data-guide.md)

  • Nunca publicar/ativar a partir de disparo agendado ou não interativo (schedule, /loop sem 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 / sintomaCausaSolução
1870197 "targeting_optimization … removed"Enviou o campo removidoRemover targeting_optimization do payload
1487079 "targeting_automation must be enabled to use age_range"age_range com Advantage offRemover age_range; usar só age_min/age_max
Entidade voltou PAUSED após editar budget/targetingEfeito colateral da APIads_activate_entity + ler de volta
INTERNAL na ativaçãoTransitório do MetaRetentar a ativação
Budget rejeitadoValor em reais, não centavos, ou < pisoConverter p/ centavos; respeitar min_daily_budget_cents
"Não consigo editar o criativo"Criativo é imutávelCriar criativo + anúncio novos
Conta não publicais_ads_mcp_enabled=false, sem pagamento, ou DISABLEDChecar retorno de ads_get_ad_accounts; resolver no Ads Manager

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.