Eastmapquest735/konquest-meta-ads-mcp

O que konquest-meta-ads-mcp faz?

Gerencie anúncios do Meta Ads com o Claude Code usando 57 ferramentas MCP para campanhas, conjuntos de anúncios, anúncios, análises, rastreamento e validação.

Visão geral

Esta skill fornece um servidor MCP que expõe mais de 57 ferramentas para interagir com a API do Meta Marketing, permitindo que você gerencie campanhas publicitárias diretamente do Claude Code.

Ferramentas disponíveis

Campanhas

• create_campaign – Cria uma nova campanha
• update_campaign – Atualiza uma campanha existente
• list_campaigns – Lista campanhas da conta
• get_campaign – Obtém detalhes de uma campanha específica
• delete_campaign – Exclui uma campanha

Conjuntos de anúncios

• create_ad_set – Cria um novo conjunto de anúncios
• update_ad_set – Atualiza um conjunto de anúncios
• list_ad_sets – Lista conjuntos de anúncios
• get_ad_set – Obtém detalhes de um conjunto de anúncios
• delete_ad_set – Exclui um conjunto de anúncios

Anúncios

• create_ad – Cria um novo anúncio
• update_ad – Atualiza um anúncio
• list_ads – Lista anúncios
• get_ad – Obtém detalhes de um anúncio
• delete_ad – Exclui um anúncio

Análises

• get_campaign_insights – Obtém métricas de desempenho da campanha
• get_ad_set_insights – Obtém métricas de desempenho do conjunto de anúncios
• get_ad_insights – Obtém métricas de desempenho do anúncio
• get_account_insights – Obtém métricas gerais da conta

Rastreamento

• create_pixel – Cria um pixel do Meta
• get_pixels – Lista pixels disponíveis
• create_conversion_event – Cria um evento de conversão
• list_conversion_events – Lista eventos de conversão
• get_conversion_event – Obtém detalhes de um evento

Validação

• validate_ad_creative – Valida um criativo de anúncio
• validate_budget – Valida um orçamento
• validate_targeting – Valida a segmentação
• validate_ad_account – Valida a configuração da conta de anúncios
• check_audience_size – Verifica o tamanho do público

Configuração

1. Obtenha um token de acesso do Meta Marketing API.
2. Configure as variáveis de ambiente:

export META_ACCESS_TOKEN=seu_token_aqui
export META_AD_ACCOUNT_ID=act_seu_id_conta
export META_APP_ID=seu_app_id
export META_APP_SECRET=seu_app_secret

3. Execute o servidor MCP:

npx @anthropic/mcp-meta-ads

Exemplos de uso

No Claude Code:

Crie uma nova campanha com orçamento diário de R$100, segmentação para São Paulo e idade entre 18-35.

Mostre os insights da campanha 'Campaña Verão 2025' dos últimos 7 dias.

Documentação

Consulte a documentação oficial da Meta Marketing API para detalhes sobre os parâmetros de cada endpoint.

Suporte

Para dúvidas ou problemas, abra uma issue no repositório: Eastmapquest735/konquest-meta-ads-mcp