Dá pra analisar os seus anúncios da Meta (Instagram e Facebook) no Claude de 2 jeitos. Opção 1, MCP oficial da Meta: você adiciona o conector da Meta no Claude e conversa com a conta pelo próprio chat, sem código. Opção 2, API Graph no Claude Code: com um token de acesso, o Claude Code puxa os números direto da API, salva em arquivo, compara semanas e roda skills de análise da comunidade. A primeira é pra perguntar e decidir na hora; a segunda é pra rotina e relatório.
Qual opção escolher
| Opção 1 — MCP no chat | Opção 2 — API Graph no Claude Code | |
|---|---|---|
| Onde roda | Claude no navegador ou no app do computador | Claude Code, no terminal |
| Precisa de código | Não | Não precisa programar, mas usa o terminal |
| Plano do Claude | Funciona até no Free (1 conector personalizado) | Pro ou Max (o Claude Code não entra no Free) |
| Como entra na conta | Login da Meta, sem token | Token de acesso que você gera |
| Serve pra | Perguntar, analisar e criar campanha com a sua aprovação | Relatório recorrente, arquivo, comparação e auditoria com skills |
Dá pra usar as duas: o chat pra olhar a conta no dia a dia, o Claude Code pro relatório da semana.
Opção 1 — MCP oficial da Meta (pelo chat)
Você precisa de uma conta no Claude e de acesso à conta de anúncios no Meta Business. O conector é da própria Meta: o login é o seu, e você escolhe quais contas de anúncios o Claude pode ver.
Passo 1 — Abra os conectores. No Claude (claude.ai ou o app do computador), clique no seu nome no canto inferior esquerdo → Configurações → Conectores. Em algumas versões o caminho aparece como Personalizar → Conectores.
Passo 2 — Adicione o conector da Meta. Clique em Adicionar conector personalizado (ou no + da tela de conectores) e preencha:
- Nome:
Meta Ads - URL do servidor:
https://mcp.facebook.com/ads
Deixe as configurações avançadas em branco e clique em Adicionar.
Passo 3 — Conecte a sua conta. Clique em Conectar ao lado do Meta Ads. Abre o login da Meta: entre com o perfil do Facebook que tem acesso à conta de anúncios, escolha o portfólio empresarial e as contas que o Claude pode ver, e confirme. Se você cuida de contas de clientes, confira bem quais marcou.
Passo 4 — Ligue na conversa. Abra uma conversa nova, clique no + no canto inferior esquerdo da caixa de mensagem → Conectores e confira se o Meta Ads está ativado.
Passo 5 — Teste. Mande o PROMPT 1 abaixo. Se voltar com os números da sua conta, está conectado.
Antes de usar cada ferramenta da Meta, o Claude pede a sua aprovação, e dá pra permitir uma vez ou sempre. Pra ler relatório, "sempre" é tranquilo. Pra criar ou editar campanha, aprove uma vez de cada vez e leia o que ele vai fazer.
No Claude Code também funciona. Se você já usa o Claude Code, um comando no terminal adiciona o mesmo conector:
claude mcp add --transport http meta-ads https://mcp.facebook.com/ads
Depois, dentro do Claude Code, digite /mcp, escolha meta-ads e faça o login da Meta no navegador que abrir.
PROMPT 1 — Raio-x dos últimos 30 dias
Use o conector da Meta. Na conta de anúncios NOME OU NÚMERO DA CONTA, puxe o desempenho dos últimos 30 dias por campanha: investimento, resultados, custo por resultado, CTR, frequência e ROAS (se houver compra). Monte uma tabela ordenada por investimento e me diga, em 5 linhas, onde está indo dinheiro sem retorno. Não altere nada na conta.PROMPT 2 — Criativo cansado
Use o conector da Meta. Liste os anúncios ativos da conta NOME OU NÚMERO DA CONTA com frequência acima de 3 ou com CTR caindo nas últimas 2 semanas, comparado às 2 semanas anteriores. Para cada um, diga se parece cansaço do criativo ou problema de público, e o que você testaria no lugar. Não altere nada na conta.PROMPT 3 — Campanha nova, pausada e com a sua aprovação
Use o conector da Meta. Na conta NOME OU NÚMERO DA CONTA, prepare uma campanha de OBJETIVO: VENDAS, LEADS OU MENSAGENS com orçamento diário de VALOR, público QUEM VOCÊ QUER ALCANÇAR e um anúncio com o texto abaixo. Crie tudo PAUSADO. Antes de criar, me mostre o resumo completo e espere eu confirmar.
Texto do anúncio: TEXTO DO ANÚNCIOOpção 2 — API Graph no Claude Code
Você precisa do Claude Code instalado (planos Pro ou Max) e ser administrador do portfólio empresarial na Meta. O token dá acesso à conta por fora do chat: trate como senha.
Passo 1 — Crie um app da Meta. Em developers.facebook.com → Meus apps → Criar app, escolha o caso de uso de anúncios (Criar e gerenciar anúncios com a API de Marketing) e vincule ao seu portfólio empresarial. O app é só o crachá que o token precisa; não precisa publicar nada.
Passo 2 — Crie um usuário do sistema. Em business.facebook.com → Configurações → Usuários → Usuários do sistema → Adicionar. Dê um nome (por exemplo claude-code) e a função Funcionário.
Passo 3 — Dê acesso à conta de anúncios. Com esse usuário selecionado, clique em Atribuir ativos → Contas de anúncios, marque a sua conta e deixe só a permissão de ver o desempenho. Pra analisar, leitura basta.
Passo 4 — Gere o token. Ainda no usuário do sistema, clique em Gerar novo token, escolha o app do Passo 1 e marque só a permissão ads_read. Escolha a validade (60 dias é mais seguro; "nunca expira" evita refazer) e copie o token na hora, porque ele aparece uma vez só.
Passo 5 — Guarde no computador, fora do código. Na pasta onde você vai trabalhar, crie um arquivo chamado .env:
META_ACCESS_TOKEN=cole_o_token_aqui
META_AD_ACCOUNT_ID=act_1234567890
O número da conta aparece no Gerenciador de Anúncios, no seletor de contas, e também na barra de endereço depois de act=. Se a pasta for um repositório Git, coloque .env no .gitignore.
Passo 6 — Teste. Abra o Claude Code nessa pasta e mande o PROMPT 4. Se voltar uma tabela com os números da conta, está funcionando.
PROMPT 4 — Puxar os números pela API
Leia META_ACCESS_TOKEN e META_AD_ACCOUNT_ID do arquivo .env, sem mostrar o token na tela. Usando a versão mais recente da Graph API da Meta (o endpoint de insights da conta de anúncios), puxe os últimos 30 dias por anúncio: campanha, conjunto, anúncio, investimento, impressões, alcance, frequência, cliques, CTR, CPC, resultados e custo por resultado. Salve em relatorios/meta-AAAA-MM-DD.csv e me mostre os 10 anúncios de maior investimento. Só leitura: não chame nenhum endpoint que altere a conta.PROMPT 5 — Comparar com a semana anterior
Compare o arquivo mais recente da pasta relatorios/ com o anterior. Mostre o que piorou mais de 20% em CTR, custo por resultado ou frequência. Para cada item, diga a causa provável e um teste para a próxima semana.Skills da comunidade (opcional, no Claude Code)
Skill é um pacote de instruções que o Claude Code aprende uma vez e usa quando você chama. Duas valem pra Meta Ads:
Claude Ads — auditoria, planejamento e criativos para 12 plataformas de anúncio (Meta, Google, TikTok, LinkedIn e outras). Na Meta, ele analisa o relatório que você entrega (o arquivo do PROMPT 4 ou a exportação do Gerenciador de Anúncios) e não mexe na conta: qualquer mudança sai como rascunho pra você aplicar. Pra instalar, rode no Claude Code:
/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads
Instalado como plugin, os comandos começam com /claude-ads:ads — por exemplo /claude-ads:ads meta (auditoria da Meta), /claude-ads:ads create (textos e criativos), /claude-ads:ads plan (planejamento) e /claude-ads:ads report (relatório).
Competitive Ads Extractor — abre a Biblioteca de Anúncios da Meta, junta os anúncios ativos dos concorrentes e mostra que dor cada um explora. Pra instalar, cole no Claude Code o PROMPT 6.
PROMPT 6 — Instalar a skill de concorrentes
Instale como skill do Claude Code a pasta competitive-ads-extractor deste repositório: https://github.com/ComposioHQ/awesome-claude-skills/tree/master/competitive-ads-extractorPROMPT 7 — Auditoria da conta com a skill
/claude-ads:ads meta
Analise o arquivo relatorios/NOME DO ARQUIVO.csv. Objetivo da conta: VENDAS, LEADS OU MENSAGENS. Custo por resultado que eu considero bom: VALOR.PROMPT 8 — 20 variações de texto
/claude-ads:ads create
Crie 20 variações de texto para anúncio na Meta.
Produto: O QUE VOCÊ VENDE
Público: QUEM COMPRA
Objetivo: VENDAS, LEADS OU MENSAGENS
Tom da marca: COMO A SUA MARCA FALAPROMPT 9 — O que os concorrentes estão rodando
Use a skill competitive-ads-extractor: pegue os anúncios ativos de CONCORRENTE 1, CONCORRENTE 2 e CONCORRENTE 3 na Biblioteca de Anúncios da Meta. Diga que dor cada um explora, que formato mais se repete e qual ângulo nenhum deles está usando.Rotina semanal
- Segunda, no chat (Opção 1): PROMPT 1 pra ver como a semana começou.
- Segunda, no Claude Code (Opção 2): PROMPT 4 e depois PROMPT 5, pra ter o arquivo da semana e a comparação.
- Planejando campanha: PROMPT 9 nos 3 principais concorrentes.
- Antes de subir anúncio novo: PROMPT 8 pra ter variações de texto.
- Sexta: PROMPT 7 no arquivo da semana.
Cuidados
- Token é senha. Quem tem um token com
ads_readvê todos os números da conta; com permissão de gerenciar, cria anúncio e gasta o seu orçamento. Pra analisar, gere só comads_read, guarde no.enve nunca cole no chat, em print ou no Git. Se vazar, vá em Usuários do sistema e revogue o token. - No MCP, a decisão é sua. O Claude pede aprovação antes de usar as ferramentas da Meta. Pra criar ou editar campanha, aprove uma vez de cada vez e peça sempre a campanha pausada.
- Agência com várias contas: no login da Meta, marque só as contas que você vai analisar.
- Os números vêm da Meta; a leitura é do Claude. Antes de cortar orçamento, confira no Gerenciador de Anúncios: a janela de atribuição muda o resultado.
