MCP do Ads Editor: 336 ferramentas para Claude, ChatGPT, Codex e Cursor

Lista contas de anúncio Meta (Facebook/Instagram) conectadas ao usuário. status é o account_status da Meta: 1 ativa, 2 desabilitada pela Meta, 3 pagamento pendente.

Verifica se há token Meta válido conectado ao usuário (sem detalhes do token).

Dashboard executivo de uma conta Meta com campanhas, orçamentos, status da conta e indicadores de saúde (billing_error, account_status, disable_reason). account_alert traz o aviso pronto quando a conta não está ativa…

Insights em nível de conta Meta com métricas agregadas de todas as campanhas no período (spend, clicks, impressions, conversions, ROAS, etc.).

Insights Meta SEGMENTADOS por breakdown: age, gender, country, region, publisher_platform, platform_position, device_platform, impression_device ou hourly_stats_aggregated_by_advertiser_time_zone (máx. 2 combinados…

Resumo agregado de uma conta de anúncio Meta no período (totais únicos: spend, impressions, clicks, conversions).

Recursos disponíveis em uma conta Meta para uso em clonagem cross-account: páginas FB, contas IG, números WhatsApp, pixels e aplicativos (destino "Aplicativo" do wizard).

Informações administrativas de uma conta Meta: nome, moeda, fuso horário, Business Manager vinculado, status e motivo de desativação se aplicável.

Cobranças de uma conta Meta no período, as mesmas do botão "Cobranças" do Gerenciador e do Monitor de Contas: cada cobrança com data e hora, o valor que saiu do cartão (valor_cobrado_centavos, COM imposto…

Ativa contas Meta no plano (só a pedido; usa vaga).

Desativa contas Meta no plano (pede confirmar).

Lista campanhas, conjuntos de anúncios ou anúncios de uma conta Meta.

Detalhes completos de uma campanha Meta: nome, objetivo, status, bid_strategy, budget mode, datas, special_ad_categories.

Métricas (spend, impressions, clicks, CTR, CPM, CPC, ROAS, conversions) de uma campanha, adset ou ad no período.

Busca orçamentos (daily/lifetime) de múltiplas campanhas em batch, incluindo budgets de adsets filhos.

Andamento do orçamento em etapas iniciado por update_budget ou update_google_budget com repeat ≥ 2: etapa atual, quantas etapas cada item já aplicou, o valor em que está e o erro de quem parou. status=done quando…

Lista os eventos PERSONALIZADOS do pixel de uma conta Meta (ex.: DEPOSIT_3, SIGNUP), com a contagem recente de cada um.

Retorna o catálogo de combinações válidas objetivo → destino → otimização do Meta (com rótulos PT/EN, inputs obrigatórios de cada combinação e eventos de conversão).

Pausa uma campanha, conjunto de anúncios ou anúncio Meta (atua sobre qualquer object_id).

Ativa uma campanha, conjunto de anúncios ou anúncio Meta (atua sobre qualquer object_id).

Pausa ou ativa especificamente uma campanha Meta (status=ACTIVE|PAUSED).

Edita o nome de uma campanha Meta. Outros campos (objetivo, bid_strategy) não podem ser alterados após criação.

Atualiza o orçamento (diário ou vitalício, o que o item já usa) de uma campanha (CBO) ou conjunto de anúncios (ABO).

Exclui uma campanha Meta permanentemente (atenção: ação irreversível, exclui também adsets e ads filhos).

Cria uma campanha Meta do zero, SEMPRE PAUSED.

Clona uma campanha Meta (mesma conta ou cross-account) com adsets e ads.

Lista conjuntos de anúncios (adsets) de uma conta Meta com métricas, targeting, budget e bid_strategy.

Busca destination_type, optimization_goal e promoted_object de adsets de múltiplas campanhas (usado no preload do modal de clonagem para decidir overrides de página/pixel/WhatsApp).

Detalhes completos de um adset: targeting, daily_budget/lifetime_budget, bid_amount, bid_strategy, optimization_goal, destination_type, promoted_object, billing_event.

Insights específicos de um adset (spend, impressions, clicks, conversions, ROAS, etc.) no período.

Pausa especificamente um conjunto de anúncios Meta (status=PAUSED).

Ativa especificamente um conjunto de anúncios Meta (status=ACTIVE).

Pausa ou ativa um conjunto de anúncios (status=ACTIVE|PAUSED).

Exclui um conjunto de anúncios permanentemente (também exclui ads filhos).

Clona um adset (mesma conta ou cross-account) com seus anúncios opcionalmente.

Atualiza bid_amount (R$) e/ou bid_strategy de um adset.

Define, troca ou remove a DATA DE TÉRMINO de um conjunto de anúncios (end_time) ou de uma campanha (stop_time) que já existe.

Lista anúncios (ads) de uma conta Meta. Atalho de list_campaigns com level=ads.

Lista anúncios com thumbnails e métricas no período.

Detalhes completos de um anúncio Meta incluindo creative spec (object_story_spec com link_data/video_data), asset_feed_spec, degrees_of_freedom_spec, url_tags e info do adset (destination_type, promoted_object).

Insights de um anúncio específico (spend, impressions, clicks, conversions, ROAS, breakdown por dispositivo etc.) no período.

Retorna permalinks (URL pública) dos posts vinculados a anúncios Meta, Instagram (instagram.com/p/) ou Facebook (effective_object_story_id).

Mostra como está uma fila de upload de anúncios (a mesma que o editor usa), pelo queue_id devolvido por create_ads_from_media: quantos já subiram, quais falharam e por quê.

Edita um anúncio Meta. Pode alterar nome, texto (message), título (title/headline), variações de texto e de título (message_variants, title_variants), URL (link), UTMs (url_tags), CTA, mensagens WhatsApp e flags…

Desativa em LOTE todas as recomendações/aprimoramentos automáticos do criativo nos anúncios de uma conta.

Pausa especificamente um anúncio Meta (status=PAUSED).

Ativa especificamente um anúncio Meta (status=ACTIVE).

Pausa ou ativa um anúncio Meta (status=ACTIVE|PAUSED).

Exclui um anúncio Meta permanentemente. Ação irreversível.

Clona um anúncio Meta para um conjunto de destino, na MESMA conta ou em OUTRA conta de anúncios.

Pausa em lote até 50 anúncios Meta. Valida ownership de cada anúncio antes de pausar.

Ativa em lote até 50 anúncios Meta e relê status/effective_status. ok confirma ACTIVE no momento da leitura; não garante veiculação nem impede revisão posterior da Meta.

Cria um anúncio Meta a partir de uma URL pública do Instagram (post, reel, tv ou stories).

Faz upload de um arquivo de mídia (imagem ou vídeo) para uma conta Meta Ads.

Coloca UM arquivo de mídia no Ads Editor para depois virar anúncio com create_ads_from_media.

Cria anúncios a partir de arquivos de mídia, usando a MESMA fila do editor: um anúncio por arquivo em cada conjunto, com nome sequencial (AD01, AD02...) e texto, Página, Instagram e UTM herdados do conjunto quando…

Baixa imagem e vídeo de um link do Google Drive e deixa pronto para create_ads_from_media.

Atualiza o criativo de um anúncio Meta com novo vídeo (video_id) ou imagem (image_hash).

Status de um job de batch async. Retorna processing/done/partial/error com progresso (done/ok/failed/total) e results.

Atualiza múltiplos objetos Meta (campanhas, conjuntos, anúncios) em paralelo, síncrono.

Versão assíncrona de batch_update_objects para lotes grandes (> 50).

Lista públicos personalizados (custom audiences) de uma conta Meta, usados como fonte de Lookalike, retargeting etc.

Retorna tamanho aproximado de um público Meta (lower/upper bound) + status de operação e entrega.

Diagnóstico completo de um público: subtype, rule, rule_v2, retention_days, customer_file_source, lookalike_spec, operation_status, delivery_status, timestamps.

Status de um job de criação de públicos (em background).

Lista campanhas de uma conta Meta (id, name, objective), usadas como fonte de filtro em públicos por eventos de campanha.

Cria um público personalizado (custom audience) Meta.

Cria um público de LISTA DE CLIENTES (custom audience por arquivo) na Meta: lê um CSV ou XLSX com e-mail, telefone, nome, cidade etc., normaliza, hasheia (SHA-256) e envia.

Cria público de ENVOLVIMENTO/engajamento do Instagram ou Facebook, monta a regra Meta correta automaticamente (resolve a conta IG/página da conta de anúncio).

MODO AUTOMÁTICO de públicos Meta (o cartão "Sugerir públicos (automático)" da aba Meta de Públicos): lê os ativos reais da conta (Instagram, Página, vídeos das campanhas, pixel com eventos que têm veiculação…

Cria os públicos dos pacotes de suggest_meta_audiences que o usuário aprovou (como "Criar selecionados" da tela): relê a conta, junta os pacotes escolhidos e inicia a MESMA fila de criação da tela em segundo plano…

Clona um público personalizado Meta existente (mesma conta ou cross-account).

Deleta um público customizado Meta. Valida ownership: o público deve estar em uma conta acessível pelo token Meta do usuário.

Lista páginas Facebook do usuário (de múltiplas fontes: me/accounts, promote_pages, Business Manager).

Busca contas Instagram por username (ou retorna as do usuário se sem query).

Lista vídeos publicados por uma página Facebook (utilizados como fonte para público de Video View).

Lista vídeos (Reels, IGTV, posts de vídeo) de uma conta Instagram para uso em públicos de Video View. ig_user_id é o id da CONTA do Instagram conectada (começa com 1784..., vem de lookup_instagram_user sem query ou…

Lista vídeos que já foram usados em campanhas de uma conta Meta (com video_id e thumbnail).

Retorna contagem de seguidores de IGs vinculados a uma ou mais contas Meta.

Lista eventos de conversão (ViewContent, AddToCart, Purchase, Lead, etc.) rastreados por um pixel Meta, usado para criar públicos de site_event.

Lista os formulários instantâneos (Lead Ads) da Página.

Lista os anúncios de uma conta Meta que usam formulário instantâneo (Lead Ad), dizendo qual formulário cada um usa.

Troca o formulário instantâneo (Lead Ad) de um anúncio.

Duplica um formulário instantâneo da Página, copiando perguntas, política de privacidade, tela de agradecimento e cartão de contexto.

Cria um formulário instantâneo simples na Página: nome, política de privacidade e site de destino (ambos https e EXIGIDOS pela Meta) e as perguntas padrão nome completo, e-mail e telefone.

Busca localizações Meta (cidade, região/estado, país, CEP/ZIP, grupos como "worldwide"/continentes) pelo nome.

Lê as localizações ATUAIS (include/exclude) de cada conjunto de anúncios Meta informado, uma linha por conjunto.

Edita a LOCALIZAÇÃO de vários conjuntos Meta de uma vez, preservando o resto da segmentação de cada um (idade, gênero, públicos, posicionamento). mode="add" ACRESCENTA às localizações que cada conjunto já tem…

Lista os modelos de aparelho que a Meta aceita segmentar (user_device), filtrando por sistema operacional e busca por nome.

Define dispositivo móvel e sistema operacional dos conjuntos Meta (user_os / user_device / versão do SO / somente Wi-Fi).

Lista as NOTAS que o gestor escreveu na conta de anúncio Meta (botão "Notas" do Gerenciador): o histórico do que foi feito e por quê, da mais nova para a mais antiga.

Acrescenta uma NOTA nova na conta de anúncio Meta (aparece no botão "Notas" do Gerenciador, com a data).

Mostra se a campanha Meta usa orçamento na campanha (CBO) ou nos conjuntos (ABO).

Diz, para cada conjunto Meta, se o PÚBLICO ADVANTAGE+ está ligado (lido na Meta na hora; a tabela do gerenciador não traz). apenas_idade=true quando só a idade está em modo Advantage.

Troca o orçamento entre campanha (CBO) e conjuntos (ABO). target="CBO" (orçamento na campanha, informe campaign_budget em reais por dia) ou target="ABO" (orçamento em cada conjunto, informe adset_budgets com TODOS os…

Cria uma CONVERSÃO PERSONALIZADA para cada evento personalizado do pixel (os nomes saem de list_pixel_custom_events), para o evento ganhar coluna própria (contagem e custo) no Gerenciador e nos relatórios.

Troca os POSICIONAMENTOS de conjuntos Meta em lote, preservando o resto da segmentação de cada um (público, local, idade, interesses). mode="auto" = posicionamentos Advantage+ (automáticos); mode="manual" = só os…

Liga ou desliga o PÚBLICO ADVANTAGE+ em conjuntos Meta (ligado=true/false).

Troca a mídia do feed ou dos stories de um anúncio Meta. grupo="feed" (Feed, Explorar, Marketplace, Pesquisa) ou grupo="stories" (Stories, Status e Reels, formato vertical).

Volta o anúncio Meta a uma mídia só. Ele passa a ter UMA mídia para todos os posicionamentos (a do feed, ou a de grupo="stories" se pedido), com os mesmos textos e destino. GRAVA NA CONTA (criativo novo, volta para…

Lista os catálogos de produtos que a conta Meta usa (e, quando o perfil tem a permissão, todos os catálogos dos negócios dele), com os conjuntos de produtos já usados nas campanhas.

Lista os conjuntos de produtos de um catálogo (id, nome, quantidade).

Lista os produtos de um catálogo (id, nome, retailer_id, imagem).

Andamento de create_catalog_ads_from_media ou bulk_edit_meta_catalog: status (processing ou done), quantos itens terminaram e, por item, o produto e o conjunto criados (sku, product_set_id), os anúncios de cada…

Lista as trocas de mídia de catálogo marcadas para uma hora (nome, SKU, horário de Brasília já em UTC, status).

Cria um ANÚNCIO DE CATÁLOGO em cada conjunto escolhido (a aba "Anúncio de catálogo" do Meta Ads Editor). product_set_id="proprio" usa o conjunto de produtos que cada conjunto de anúncios já promove (recomendado em…

Gestão do catálogo de produtos (a mesma da tela). operation: create_catalog {name, business_id?}, rename_catalog {catalog_id, name}, create_set {catalog_id, name, filter}, update_set {catalog_id, set_id, name…

Cada foto ou vídeo vira um PRODUTO do catálogo, num CONJUNTO DE PRODUTOS só dele (mesmo nome) e, com adset_ids, um ANÚNCIO DE CATÁLOGO em cada conjunto de anúncios escolhido (o "Um conjunto novo para cada mídia" da…

Edita VÁRIOS produtos ou conjuntos de produtos do catálogo de uma vez (o "Editar em massa" do Gerenciar produtos e conjuntos). target=products ou sets; change: image (trocar imagem), video (trocar vídeo), link (mudar…

Marca a troca da mídia de UM produto de catálogo para uma hora, a mesma opção "Trocar esta mídia em" do envio de anúncio de catálogo.

Aplica AGORA as trocas de mídia de catálogo que estão pendentes nesta conta, sem esperar a hora marcada.

Anúncios que contam no limite de 50 do conjunto (pausados contam e vêm sugeridos).

Libera o limite de 50 anúncios apagando os escolhidos (irreversível).

Lista contas Google Ads conectadas (diretas + MCC managed + clientes de MCC).

Verifica se há token Google Ads válido conectado (sem detalhes do token).

Estado REAL de contas Google Ads, o mesmo indicador do topo do gerenciador Google (não só "token conectado"): conta ativa, suspensa, cancelada, encerrada, inativa (rótulo "Conta inativa"), sem forma de pagamento…

Retorna contas Google Ads previamente selecionadas pelo usuário (salvas no perfil).

Retorna optimization_score (0-100) e estimativas de impacto para uma conta Google Ads.

Lista as recomendações nativas do Google Ads de uma conta, já traduzidas: título, o que propõem (valores atuais e sugeridos), mudanca (o que muda se aplicar), estimativa do Google, aplicavel (dá para aplicar pelo Ads…

Salva a seleção de contas Google Ads do usuário (customer_ids) no perfil.

Ativa contas Google no plano (só a pedido; usa vaga).

Desativa contas Google no plano (pede confirmar).

APLICA recomendações nativas do Google Ads (de list_google_recommendations) na conta, com os valores que o próprio Google sugeriu.

DISPENSA recomendações nativas do Google Ads (de list_google_recommendations): elas saem da lista aqui e no Google Ads, sem mudar nada nas campanhas.

Lista campanhas Google Ads de uma conta com status, bidding_strategy_type, optimization_score, budget e métricas de performance.

Retorna apenas métricas (spend, impressions, clicks, CTR, conversions, ROAS) de campanhas Google Ads no período.

Detalhes completos de uma campanha Google Ads específica.

Lê o Sufixo do URL final (final_url_suffix, é AQUI que moram as UTMs; o campo existe no Ads Editor) de UMA campanha Google Ads, mais o modelo de rastreamento (tracking_url_template) e os parâmetros personalizados.

Lista o Sufixo do URL final (final_url_suffix, o campo de UTM) da CONTA Google Ads e de cada campanha ativa ou com gasto em 30 dias.

Lista a segmentação geográfica atual de uma campanha Google Ads: localizações (cidade/região/país, com nome resolvido) e raios por endereço (proximity).

Lista asset groups (Performance Max) de uma campanha Google Ads com métricas.

Lista as imagens já enviadas à conta Google Ads (biblioteca de assets), com id, dimensões, formato e os usos possíveis em Performance Max (marketing 1.91:1, square 1:1, logo, portrait).

Lista os canais do YouTube conectados nesta conta para enviar vídeos não listados.

Lista os vídeos de um canal do YouTube já conectado (list_google_youtube_channels), inclusive os não listados, do mais novo para o mais antigo, 25 por página.

Lê um grupo de recursos (asset group) de uma campanha Performance Max: nome, status, URL final e todas as peças por tipo (títulos, títulos longos, descrições, nome do negócio, imagens, logotipos, vídeos), cada peça…

Série diária agregada da conta Google Ads (gasto, impressões, cliques, conversões por dia).

Pausa uma campanha Google Ads (PAUSED).

Ativa uma campanha Google Ads (ENABLED).

Altera o status de uma campanha Google Ads (ENABLED, PAUSED ou REMOVED).

Atualiza orçamento de uma campanha Google Ads.

Duplica uma campanha Google Ads na MESMA conta.

Edita o Sufixo do URL final (final_url_suffix) de UMA campanha Google Ads, é o campo de UTM, e ele EXISTE no Ads Editor.

Grava o Sufixo do URL final (final_url_suffix) com a UTM padrão do Ads Editor.

Renomeia uma campanha Google Ads (só o nome muda; status, orçamento e segmentação não).

Altera a segmentação geográfica de uma campanha Google Ads.

Cria uma campanha PERFORMANCE MAX do zero no Google Ads (orçamento + campanha + grupo de recursos com títulos, títulos longos, descrições, nome do negócio, imagens e logotipo + temas de busca + localização), numa…

Envia uma imagem PNG ou JPEG (base64, até 5 MB) para a biblioteca da conta Google Ads e devolve o asset_id para usar em Performance Max.

Sobe um VÍDEO para o Google Ads pelo endereço: o servidor baixa o arquivo (file_url https público, ou link do Google Drive de UM arquivo compartilhado como "qualquer pessoa com o link", o link INTEIRO do…

Edita o grupo de recursos de uma campanha Performance Max: adiciona títulos, títulos longos, descrições, nome do negócio, imagens (por asset_id), vídeos, temas de busca e públicos (audience_ids, sinal); remove peças…

Altera estratégia de lances de uma campanha Google Ads (MANUAL_CPC, ENHANCED_CPC, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE) com parâmetros opcionais.

Cria campanha Google Ads do zero, do tipo SEARCH, DISPLAY ou DEMAND_GEN (Geração de demanda), SEMPRE PAUSED.

Clona uma campanha do Google Ads para OUTRA conta de anúncios.

Lista ad groups de uma campanha Google Ads com bid, status e métricas.

Lista TODOS os ad groups de uma conta Google Ads (sem filtro de campanha), com métricas do período.

Lista anúncios de um ad group Google Ads (headlines, descriptions, URLs, métricas).

Lista TODOS os anúncios de uma conta Google Ads, com métricas do período.

Detalhes completos de um anúncio Google Ads, headlines (pinned), descriptions, display_url, final_url, tracking_template, custom_parameters, ad_strength.

Cria um GRUPO de anúncios novo sob uma campanha de Pesquisa que já existe, com palavras-chave e, opcionalmente, o primeiro anúncio responsivo.

Cria um anúncio responsivo de Pesquisa (RSA) novo sob um grupo que já existe.

Renomeia um grupo de anúncios do Google Ads.

Define o CPA desejado de um GRUPO de anúncios (em reais).

Altera status de um ad group Google Ads (ENABLED, PAUSED, REMOVED).

Pausa um ad group Google Ads.

Ativa um ad group Google Ads.

Clona um ad group Google Ads (com ads e keywords) para outra campanha.

Altera status de um anúncio Google Ads (ENABLED, PAUSED, REMOVED).

Edita Responsive Search Ad Google (headlines, descriptions, final_url, tracking_template).

Copia um Responsive Search Ad (RSA) do Google Ads para o MESMO grupo ou para outro grupo da mesma conta.

Lista keywords de um ad group Google Ads com match_type, bid, status, quality_score e métricas.

Planejador de palavras-chave do Google: sugestões com volume de busca e CPC REAIS da conta, a partir do site e/ou de sementes.

Termos de busca reais que UMA palavra-chave específica acionou, com métricas.

Search Terms Report Google Ads: queries reais que dispararam anúncios, com status (ADDED, EXCLUDED, NONE) e métricas.

Adiciona keyword a um ad group Google Ads com match_type (BROAD, PHRASE, EXACT) e bid opcional.

Pausa, reativa ou muda o lance de uma keyword Google Ads.

Remove uma keyword Google Ads de um ad group.

Adiciona negative keyword Google Ads em nível de campanha (campaign_id) ou ad group (ad_group_id).

Troca o tipo de correspondência de uma palavra-chave (BROAD, PHRASE, EXACT).

Lista extensões (sitelinks, callouts e structured snippets) Google Ads de uma conta ou de uma campanha específica (campaign_id).

Varre as extensões da conta nos três níveis (conta, campanha e grupo) e devolve deduplicado.

Cria e vincula sitelinks Google Ads a uma campanha.

Cria e vincula callouts (frases de destaque, até 25 chars cada) Google Ads a uma campanha.

Cria e vincula um structured snippet Google Ads a uma campanha: um header (ex: Serviços, Marcas, Cursos, Destinos) e uma lista de valores (até 25 chars cada).

Edita uma extensão do Google Ads (sitelink, frase de destaque ou snippet).

Desvincula uma extensão do Google Ads do nível em que ela está (conta ou campanha).

Lista as ações de conversão (conversions) ativas de uma conta Google Ads: id, nome, categoria, tipo e se é primária.

Mostra as metas de conversão de uma campanha Google Ads: se ela usa as metas da CONTA (mode=account) ou conversões ESPECÍFICAS desta campanha (mode=specific) e quais (selected_action_ids).

Cria uma ação de conversão (tipo página web) na conta Google Ads e devolve a TAG (global site tag + event snippet) para o usuário instalar no site. category deve ser uma de: SUBMIT_LEAD_FORM, CONTACT, PURCHASE…

Remove (arquiva) uma ação de conversão da conta Google Ads.

Define as metas de conversão de uma campanha Google Ads. mode="account" faz a campanha herdar as metas da conta; mode="specific" faz a campanha otimizar só pelas conversões escolhidas (conversion_action_ids…

Lista a demografia de um grupo de anúncios de Pesquisa do Google Ads: gênero, faixa etária, renda familiar e status parental, com o estado de cada valor (padrao, ajustado com +/- %, excluido) e as métricas do período…

Altera UM valor demográfico de um grupo de anúncios de Pesquisa. action: "exclude" (negativa o público: o grupo deixa de anunciar para ele), "adjust" (ajuste de lance em %, de -90 a +900, ex.: adjustment_pct 20 =…

Desempenho do Google Ads por SEGMENTO no período: dimension "device" (celular, computador, tablet, TV), "hour" (hora do dia, 0 a 23), "day_of_week" (segunda a domingo) ou "landing_page" (página de destino, agrupada…

Mostra a programação de anúncios de uma campanha do Google Ads (dias e faixas de horário com o ajuste de lance de cada uma; lista vazia = todos os horários) e o ajuste de lance por aparelho (celular, computador…

Define a programação de anúncios de uma campanha do Google Ads.

Ajusta o lance de UM aparelho numa campanha do Google Ads: device MOBILE, DESKTOP ou TABLET (CONNECTED_TV só quando a campanha já mostra esse aparelho) e adjustment_pct de -90 a 900, ou -100 para tirar o aparelho da…

Lista as listas compartilhadas de palavras negativas da conta do Google Ads, com o total de palavras e as campanhas que usam cada uma.

Cria uma lista compartilhada de palavras negativas na conta do Google Ads, já com as palavras (opcional) e já aplicada nas campanhas de campaign_ids (opcional), numa chamada só.

Adiciona palavras negativas a uma lista compartilhada do Google Ads.

Remove palavras de uma lista compartilhada de negativas do Google Ads, pelo criterion_id de cada uma (list_google_negative_keyword_lists com list_id mostra os ids).

Aplica uma lista compartilhada de negativas em campanhas do Google Ads (as palavras da lista passam a bloquear as buscas nelas).

Retira uma lista compartilhada de negativas de campanhas do Google Ads (a lista continua existindo e pode ser aplicada de novo).

Lista os públicos da conta Google Ads: listas de remarketing (site, combinação, listas do Google), segmentos personalizados e públicos (os que entram em PMax e Demand Gen), com tamanho, se está aberta/fechada, se dá…

Mostra os públicos ligados a uma campanha, grupo de anúncios ou grupo de recursos (PMax): nome, tipo, se é exclusão e o link (usado para desligar e para ajustar o lance), o ajuste de lance atual (ajuste_pct), o modo…

MODO AUTOMÁTICO de públicos do Google: varre a conta (termos de pesquisa e palavras-chave que converteram, páginas de destino com clique, listas que já existem, públicos em observação que convertem) e devolve os…

Sites de CONCORRENTES para o segmento personalizado do Google (campo Sites).

Cria um SEGMENTO PERSONALIZADO no Google Ads: pessoas que pesquisam certos termos, visitam sites parecidos (inclusive de concorrentes) ou usam certos apps.

Cria uma lista de REMARKETING DE SITE no Google Ads (quem visitou páginas cujo endereço contém, é igual, começa ou termina com algo), com duração em dias.

Cria uma COMBINAÇÃO de listas de remarketing no Google Ads: incluir quem está em todas (include_all) ou em qualquer (include_any) e tirar quem está em outras (exclude).

Edita um público do Google Ads criado na conta: troca o nome e, conforme o tipo, as regras e a duração (remarketing de site), os termos/sites/apps (segmento personalizado) ou as listas (combinação).

Exclui um público do Google Ads (lista de remarketing, segmento personalizado ou público).

Liga, desliga ou muda o modo de públicos numa campanha, grupo de anúncios ou grupo de recursos do Google Ads. action "add" + audiences + mode: observation (padrão; só ajusta lance, não restringe), targeting (só…

Ajusta o lance de UM público ligado (em observação ou segmentação) numa campanha ou grupo de anúncios do Google Ads: adjustment_pct de -90 a +900 (0 = sem ajuste).

Lista os modelos de campanha Google salvos no Ads Editor (os mesmos do assistente "Criar campanha"): id, nome, tipo, conta de origem e data.

Aplica um modelo salvo: devolve os campos do modelo e create_args prontos para a tool de proxima_tool, na conta customer_id.

Lê uma campanha Google existente e devolve os campos dela no formato do assistente, com create_args para criar uma parecida (nome com "(cópia)").

Monta com IA, em um passo, o rascunho de uma campanha Google a partir do site, do orçamento e da cidade: palavras-chave, negativas, títulos, descrições e extensões (Pesquisa) ou títulos longos, nome do negócio, temas…

Salva um modelo de campanha Google no Ads Editor (o mesmo que o assistente usa).

Exclui um modelo de campanha Google salvo no Ads Editor.

Lista a data de início e a data de término das campanhas do Google Ads de uma conta (fuso da conta).

Lista os rótulos (labels) de uma conta do Google Ads, com cor e quantos itens usam cada um, e quais campanhas, grupos e anúncios têm cada rótulo (mapas campanhas/grupos/anuncios: id do item para ids de rótulo).

Define, troca ou remove a DATA DE TÉRMINO de campanhas do Google Ads que já existem (uma ou várias da mesma conta), e a data de início de campanha que ainda não começou.

Cria um rótulo (label) na conta do Google Ads, com nome (1 a 80 caracteres), cor de fundo #RRGGBB e descrição opcional.

Aplica ou retira um rótulo em vários itens de UMA conta do Google Ads: campanhas (level=campaign, ids das campanhas), grupos de anúncios (level=adgroup) ou anúncios (level=ad, cada id no formato GRUPO~ANUNCIO, ex.

Renomeia um rótulo do Google Ads ou troca a cor (#RRGGBB) e a descrição.

Remove um rótulo da conta do Google Ads.

Lista os experimentos (teste A/B) do Google Ads de uma conta, ou de uma campanha: estado (em preparação, agendado, em andamento, encerrado, aplicado), divisão de tráfego, campanha original e campanha de teste, e o…

Cria um experimento (teste A/B) a partir de UMA campanha de Pesquisa ou Display do Google Ads.

Encerra um experimento do Google Ads em andamento: o teste para de receber tráfego e a campanha original segue como estava, sem a mudança.

Aplica um experimento do Google Ads em andamento: o Google leva a mudança do teste (lance ou página de destino) para a campanha ORIGINAL e encerra o teste.

Remove um experimento do Google Ads que ficou em preparação (não agendado).

Diz se a conta do Google Ads tem Merchant Center vinculado (exigência para campanha de Shopping e para Performance Max com produtos) e lista as lojas: vinculadas (merchant_id que serve para Shopping e PMax, com…

Liga (ou troca) o Merchant Center numa campanha PERFORMANCE MAX que já existe, como o bloco Merchant Center / Google Shopping do Editar grupo de recursos: vale para a campanha inteira, e cada grupo de recursos sem…

Cria uma campanha de Shopping padrão no Google Ads (orçamento, campanha ligada ao Merchant Center, grupo com todos os produtos do feed e o anúncio de produto), PAUSADA por padrão.

Lista as Otimizações por IA do GOOGLE ADS do usuário (motor google_ads_scales): modo suggest/auto, flags de autonomia (negativar, pausar keyword, orçamento, realocação), tetos, sazonalidade e o last_analysis do…

Lista as sugestões PENDENTES do motor de Otimização Google (negativar termo, incluir/pausar palavra-chave, troca de lance, orçamento, tetos, PMax, extensões, criar PMax nova…), com título, explicação, payload (o que…

Monta o rascunho da Performance Max sugerida pela Otimização Google (sugestão kind "pmax_create" de list_google_optimization_suggestions): parte da melhor campanha de Pesquisa da conta (URL, localização, idiomas…

Histórico de AÇÕES de uma Otimização Google (automáticas e aprovadas): o que mudou, de quanto para quanto (orçamentos em R$), o motivo e a evidência, pronto para exibir, com chips e grupos…

Decide VÁRIAS sugestões pendentes da Otimização Google de uma vez (até 50).

APROVA uma sugestão pendente da Otimização Google: executa a mutação no Google Ads (mesma porta de escrita do motor, com validate_only antes) e registra a decisão como treino. note (opcional) vira comentário de…

RECUSA uma sugestão pendente da Otimização Google, sem tocar na conta.

Liga/desliga uma Otimização Google (pausa ou retoma o motor naquela conta).

Exclui uma Otimização por IA do Google. As sugestões e o histórico dela caem junto. Requer uma Otimização por IA do Google já ativada na conta.

Duplica a configuração de uma Otimização por IA do Google para outra conta ou campanha.

Grava o comentário de treino GERAL da otimização, o que o motor deve levar em conta sempre.

Desfaz UMA ação que o motor do Google já executou (volta o valor anterior no Google Ads).

Diz se uma ação do histórico do motor foi certa ou errada.

Conversão offline do Google numa conta: a configuração (ação de conversão "Importar de cliques", projetos de integração, status de venda, valor, consentimento, ligada ou não), as ações de upload da conta, os projetos…

Liga, desliga ou ajusta a conversão offline do Google numa conta: a venda que chega por webhook com gclid/gbraid/wbraid é enviada sozinha ao Google (a cada 10 minutos).

Envia AGORA ao Google as vendas novas com clique da conta (o envio automático roda a cada 10 minutos).

Envia ao Google UMA venda fechada fora do checkout (CRM, WhatsApp) pelo identificador do clique: gclid, gbraid ou wbraid (só um), com o número do pedido, o valor e a data.

Lista as análises por IA já feitas numa conta: criativos da conta, concorrentes (biblioteca de anúncios), estudos de criativos e diagnósticos da conta.

Abre o RELATÓRIO de uma análise por IA já feita (criativos da conta, concorrente, estudo ou diagnóstico): síntese, o que funciona, o que limita, briefs, experimentos, decisões e plano de 7 dias, mais o link do PDF.

Situação da análise de criativos da conta iniciada por analyze_account_creatives.

Busca os anúncios ativos de um CONCORRENTE na Biblioteca de Anúncios da Meta (nome da página, @ ou link do Facebook/Instagram) e guarda no acervo da conta.

As últimas análises de mídia de concorrente da conta (modo=midia de analyze_competitor_ads): situação de cada uma e, quando concluída, o analysis_id para abrir com get_ai_analysis.

Analisa com IA os criativos da PRÓPRIA conta (vídeo e imagem assistidos pela IA, com as métricas de cada anúncio): o que funciona, o que limita, padrões e sugestões de novos criativos.

Diagnóstico por IA da conta: nota de saúde, números da semana contra a anterior e a lista priorizada do que fazer (pausar, cortar ou aumentar verba, trocar anúncio, corrigir medição), cada ação com o número que a…

Analisa com IA UM criativo solto a partir do link: imagem (JPG, PNG, WebP, até 5 MB) ou vídeo MP4 (até 40 MB; a IA vê quadros do vídeo e lê a transcrição do áudio).

Analisa com IA anúncios de UM concorrente já buscados por search_competitor_ads (até 12 ids). modo=texto (padrão): analisa a copy, responde na hora e devolve o relatório. modo=midia: a IA assiste vídeo e imagem; roda…

Gera a SÍNTESE de uma análise de concorrente já feita: tese, funil, mapa de testes, o que copiar, adaptar e evitar, 3 briefs e 3 experimentos com regra de parada.

Lista as análises por IA já feitas numa conta Google Ads: análises dos anúncios (analyze_google_ads) e diagnósticos da conta (run_account_diagnosis com customer_id).

Abre uma análise dos anúncios Google já feita (analysis_id de list_google_ads_analyses): problemas por anúncio e por grupo de recursos da PMax e as sugestões de texto da IA.

Pesquisa os anúncios que um CONCORRENTE roda no Google, pela Central de Transparência de Anúncios: informe o site (loja.com.br ou o link) ou o nome da empresa.

Analisa os ANÚNCIOS de uma conta Google Ads: força do anúncio, títulos e descrições fracos, repetidos ou curtos, textos com desempenho Baixo segundo o Google, avisos do Google e, na Performance Max, os recursos de…

Lista todas as otimizações por IA (budget scales) configuradas pelo usuário, sem chamar Meta API (rápido).

Dashboard executivo agregado de todas as escalas: summary (spend/results/MER/ROAS/CPA), top/bottom performer e estados (healthy/risk/critical).

Summary de saúde de todas as escalas: contagens (healthy/risk/critical), score médio, categorização e o "gargalo da semana" de cada otimização (causa provável pelo funil, com confiança, se está fora da campanha e a…

Detalhes de uma escala específica (busca via list e filtra por id).

Métricas de gasto e resultados de uma escala (week_spent, month_spent, results_by_campaign).

Histórico de execuções de uma escala: ações tomadas, métricas, healthScore, ajustes de budget.

Cria uma otimização por IA (budget scale).

Atualiza uma otimização por IA existente: só os campos enviados mudam.

Exclui uma escala de orçamento permanentemente.

Ativa ou desativa uma escala de orçamento (is_active pedido, ou alterna se omitido).

Aceita o alvo sugerido de uma otimização de CADASTRO ou CONVERSA sem custo máximo informado.

Faz a otimização PAUSAR as campanhas ao atingir o teto semanal ou mensal (retomada automática na virada: segunda-feira ou dia 1), em vez de deixar cada campanha no orçamento mínimo, que deixa o gasto passar um pouco…

Liga ou desliga, nesta otimização, a escolha "rodo 1 criativo vencedor por escolha".

Compara a promessa do anúncio com mais gasto de uma campanha da otimização com a primeira dobra da página para onde ele leva (título, h1, primeiros 600 caracteres, preço e botão), por IA.

Lista regras automatizadas configuradas pelo usuário, Meta e Google (campo platform), de todas as contas, podendo filtrar por conta.

Detalhes completos de uma regra automatizada (condições, ações, schedule, calculation_period).

Histórico de execuções de uma regra: ação tomada, entities afetadas, sucesso/erro, timestamp.

Execuções recentes de todas as regras do usuário (timeline geral).

Cria uma regra automatizada. Dois formatos: (1) CONDIÇÃO + ação, metric/operator/threshold; (2) HORÁRIO puro, schedule_type "specific_date" com schedule_date e schedule_time, SEM metric: dispara a ação na hora…

Atualiza uma regra automatizada existente (Meta ou Google; a plataforma da regra não muda).

Exclui uma regra automatizada permanentemente.

Ativa ou desativa uma regra automatizada (alterna is_active).

Lista todos os alertas configurados pelo usuário, Meta e Google (campo platform), com métrica, threshold e status.

Dispara uma verificação manual de alertas (rate limited no backend).

Lista notificações in-app do usuário (lidas e não lidas).

Retorna a contagem de notificações não lidas.

Cria um alerta com métrica (cpa, cpc, cpm, ctr, spend, roas; no Google também conversions), operator (gt, lt, eq) e threshold.

Atualiza um alerta existente. campaign_objectives = [] limpa o filtro por objetivo (volta a todas as campanhas).

Exclui um alerta permanentemente.

Marca uma notificação como lida.

Marca todas as notificações como lidas.

Exclui uma notificação permanentemente.

Lista todos os relatórios criados pelo usuário autenticado (ID, título, slug, contas vinculadas, IG, Google, is_active: se o link está ativo ou desativado).

Recupera um relatório pelo seu ID (UUID) ou slug público.

Logs de acesso a um relatório (autenticado): IPs, user_agents, durações, referrers.

Dados básicos de um relatório público (por slug).

Métricas Meta Ads de um relatório público (campanhas, spend, conversions, ROAS).

Criativos (com thumbnails e métricas) de um relatório público Meta.

Insights de conta Instagram do relatório público (followers, engagement, top posts).

Métricas Google Ads de um relatório público.

Relatório Google avançado de um relatório público (ad groups, cidades, vídeos).

Cria um novo relatório vinculado a uma conta Meta (ou múltiplas) com seções pré-definidas e período.

Atualiza campos de um relatório existente (title, config, is_public, contas vinculadas). is_active=false DESATIVA o link sem excluir o relatório (cliente inadimplente, contrato pausado): o link para de abrir para…

Escreve, troca ou apaga os dois textos do topo do relatório, sem mexer no resto: comentario (observações do gestor, até 2000 caracteres) e analise (análise do período, até 6000).

GASTA CRÉDITOS DE IA DA CONTA (o mesmo custo do botão "Gerar com IA" do relatório, 1 crédito por geração).

Liga ou desliga seções do relatório em um, vários ou TODOS os seus relatórios de uma vez, sem mexer no resto da configuração.

Exclui um relatório permanentemente.

Retorna saúde do saldo de todas as contas Meta + Google do usuário: balance, days_remaining, today_spend, spend_cap, status, contas em alerta.

Lista contas ocultas do Monitor (blacklist) com data e motivo opcional.

Lista contas ocultadas pelo usuário na Central de Contas.

Oculta uma conta (Meta ou Google) do dashboard do Monitor de saldo.

Reexibe uma conta antes oculta do Monitor de saldo.

Oculta uma conta (Meta ou Google) da Central de Contas do usuário.

Reexibe uma conta antes oculta na Central de Contas.

Resumo de vendas (Hotmart/Kiwify/Eduzz/Braip) agrupado por campanha/conjunto/anúncio Meta, no período.

Lista integrações de UTMs configuradas (projetos Hotmart/Kiwify/Eduzz/Braip e suas contas vinculadas).

Lista os MODELOS do "Copiar relatório" (texto do relatório de WhatsApp) do Gerenciador Meta ou Google: nome, métricas escolhidas, saudação, cabeçalho e rodapé.

Lista os GRUPOS DE CONTAS da Central de Contas (e dos seletores de conta): nome, cor, contas Meta e Google de cada grupo.

Lê o PERFIL DA CONTA que a IA usa como contexto (Copiloto, diagnóstico e análises): tipo de negócio, site, Instagram e as notas do gestor sobre o negócio. confirmado=false quando o tipo de negócio ainda não foi…

Grava as UTMs padrão do Ads Editor (utm_source=FB, campanha, conjunto, anúncio e posicionamento com nome|id) nos parâmetros de URL de TODOS os anúncios das campanhas Meta escolhidas, pelo projeto de Integrações UTMs…

Salva um MODELO novo do "Copiar relatório" (Meta ou Google): nome, as métricas (chaves de list_report_templates.metricas_disponiveis, na ordem em que devem aparecer) e, opcionalmente, saudação, cabeçalho e rodapé.

Exclui um modelo do "Copiar relatório" (id de list_report_templates).

Cria um GRUPO DE CONTAS na Central (aparece também nos seletores de conta do Meta e do Google).

Edita um grupo de contas da Central: nome, cor e/ou a lista COMPLETA de contas (o que for enviado substitui a lista anterior daquela plataforma).

Exclui um grupo de contas da Central (as contas continuam conectadas; só o grupo some).

Atualiza o PERFIL DA CONTA para a IA: business_type (ecommerce, local_business, infoproduct, saas, agency, services ou general), website, instagram_handle e notes (o que a IA deve saber do negócio: oferta, ticket…

Cria uma OTIMIZAÇÃO POR IA DO GOOGLE para uma conta Google Ads.

Edita uma OTIMIZAÇÃO POR IA DO GOOGLE existente (id de list_google_optimizations): nome, escopo (campaign_ids/full_account), objetivo, site, metas (CPA/ROAS), orçamentos em reais, ticket médio, ações automáticas…

Resumo por conta Meta igual à tabela da Central de Contas: gasto, resultados, custo por resultado, CTR, CPM, saldo, status, seguidores do Instagram, compras e faturamento por UTM, lucro e ORÇAMENTO DIÁRIO da conta…

Lista os membros da equipe do proprietário, com nome, e-mail, função, último acesso e permissões de páginas e contas.

Consulta o histórico de ações da equipe no Ads Editor e, quando disponível, no Meta.

Resumo da equipe igual ao painel da tela Equipe: presença (online agora / último acesso), tempo com o Ads Editor aberto, dias ativos, quantas ações cada membro fez e em quais contas, no período de 7, 14 ou 30 dias.