ads-analyst
Skill0 starsChanged 4 months agoMITView on GitHub
Agente analista de dados de plataformas de anúncios com acesso ao vivo via MCP (Windsor.ai + Meta Ads). Use quando o usuário pedir análise de campanhas, extração de métricas, diagnóstico de performance, detecção de anomalias ou comparativo de períodos — sem precisar fazer upload de CSV.
In this repository9 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- campaign-auditSkill
- campaign-launcherSkill
- dashboard-creatorSkill
- html-mob-netlifySkill
- media-plannerSkill
- organic-auditSkill
- performance-optimizerSkill
- weekly-reportSkill
The file
Files
Ads Data Analyst — Agente de Análise ao Vivo
Analisa dados de plataformas de anúncios em tempo real via MCP tools disponíveis na sessão. Conectores disponíveis: Meta Ads, Google Ads, TikTok, LinkedIn, GA4, e 300+ via Windsor.ai.
Quando usar esta skill
Ativar quando o usuário:
- Pedir análise de campanhas ou conta ("analisa minha conta", "como estão as campanhas")
- Solicitar métricas ao vivo ("qual o ROAS hoje", "extrai dados do Meta Ads")
- Querer diagnóstico de performance ou anomalias
- Pedir comparativo de períodos ("compare esta semana com a anterior")
- Mencionar uma plataforma de anúncios sem subir arquivo
ETAPA 1 — Contexto obrigatório
Antes de qualquer chamada MCP, confirme com o usuário:
1. Qual cliente / conta? (nome ou ID da conta na plataforma)
2. Qual plataforma? (Meta Ads / Google Ads / TikTok / LinkedIn / outra)
3. Qual período? (padrão sugerido: últimos 7 dias vs 7 dias anteriores)
4. Qual o foco da análise?
- Visão geral de performance
- Diagnóstico (o que está errado?)
- Anomalia (o que mudou?)
- Comparativo / tendência
- Campanha ou ad set específicoSe o usuário já informou um ou mais desses pontos, não repita a pergunta — prossiga.
Verifique se existe perfil do cliente em clients/[slug]/profile.md.
Se existir, carregue o contexto (IDs de conta, KPIs, benchmarks históricos).
ETAPA 2 — Verificar conexão MCP
Windsor.ai: get_current_user → confirmar usuário autenticado
Windsor.ai: get_connectors → listar plataformas disponíveisSe o conector solicitado não estiver disponível, informe ao usuário e pergunte se deseja usar outra fonte.
ETAPA 3 — Mapear campos disponíveis
Windsor.ai: get_fields(connector_id="[plataforma]")Identifique os campos relevantes para o objetivo da análise. Consulte .claude/rules/mcp-data-guide.md para a lista de campos recomendados por plataforma e objetivo.
ETAPA 4 — Extrair dados
Via Windsor.ai (multi-plataforma)
Windsor.ai: get_data(
connector_id = "facebook" | "google_ads" | "tiktok" | ...
date_range = { start: "YYYY-MM-DD", end: "YYYY-MM-DD" }
fields = [métricas relevantes conforme objetivo]
dimensions = ["campaign_name", "adset_name"] ou nível desejado
filters = { account_id: "[ID]" } ← sempre filtrar por conta
)Via Meta Ads MCP (operações avançadas em Meta)
Para dados Meta Ads com mais detalhamento:
Meta Ads: ads_get_ad_accounts → listar contas disponíveis
Meta Ads: ads_get_ad_entities(account_id, entity_type="CAMPAIGN") → listar campanhas
Meta Ads: ads_insights_performance_trend(account_id, date_range) → tendência
Meta Ads: ads_insights_anomaly_signal(account_id) → anomalias detectadasRegra: Se o usuário não fornecer account_id, use ads_get_ad_accounts para listá-las e peça confirmação.
ETAPA 5 — Análise de dados
Aplique o framework de diagnóstico na sequência:
5.1 — Mensuração
- Pixel / tag de conversão ativo e disparando corretamente?
- Eventos de conversão configurados e recebendo dados?
- Se impossível verificar via dados disponíveis, sinalizar como ponto cego.
5.2 — Eficiência de verba
- Distribuição de gasto por campanha / ad set
- CPM, CPC, CTR, CPL, ROAS por campanha
- Quais campanhas consomem mais verba com pior resultado?
5.3 — Tendência
- Comparar período atual vs anterior (mesmo número de dias)
- Calcular variação % em KPIs principais
- Identificar se tendência é crescimento, queda ou estagnação
5.4 — Anomalias
- Desvios acima de 30% em qualquer KPI principal
- Campanhas ativas com gasto zerado ou CTR próximo de zero
- CPM acima de 2x a média histórica da conta
5.5 — Classificação com semáforo
Para cada KPI relevante, aplicar:
- 🟢 dentro ou acima do benchmark do cliente
- 🟡 desvio até 30% abaixo
- 🔴 desvio acima de 30% ou situação crítica
ETAPA 6 — Relatório de saída
Estrutura obrigatória:
## Análise — [Cliente] | [Plataforma] | [Período]
*Gerado em: [data] | Moeda: [moeda da conta]*
### Resumo Executivo
[2-3 linhas: o que está funcionando, o que está com problema, ação urgente se houver]
### Performance por Campanha
| Campanha | Gasto | Impressões | CTR | CPL/ROAS | vs Anterior | Status |
|----------|-------|------------|-----|----------|-------------|--------|
| ... | ... | ... | ... | ... | +/-X% | 🟢🟡🔴 |
### Diagnóstico
**🔴 Crítico (P0 — agir hoje)**
- [Problema] → [Causa raiz] → [Ação recomendada] → [Impacto estimado]
**🟡 Atenção (P1 — esta semana)**
- [Problema] → [Causa raiz] → [Ação recomendada]
**🟢 Oportunidade (P2 — próximo ciclo)**
- [Problema] → [Causa raiz] → [Ação recomendada]
### Próximos passos
[Lista numerada de ações priorizadas]ETAPA 7 — Oferta de execução (quando aplicável)
Se a análise resultar em recomendação de ação executável via MCP:
Windsor.ai: list_actions(connector_id="[plataforma]")Apresente ao usuário:
Posso executar esta ação diretamente na plataforma:
→ [Descrição da ação] (ex: "Pausar campanha X", "Ajustar budget para R$Y")
Confirma?Se confirmado:
Windsor.ai ou Meta Ads MCP: execute_action(...)Plataformas com escrita disponível: Meta Ads (campanhas, ad sets, ads, budgets) e Google Ads (campanhas, budgets).
Regras de segurança
- NUNCA pausar campanha sem verificar tendência dos últimos 3 dias
- NUNCA ajustar budget sem confirmar o novo valor explicitamente com o usuário
- SEMPRE pedir confirmação antes de qualquer ação de escrita
- NUNCA assumir que a conta do usuário é a mesma de sessões anteriores
Perfil de cliente (memória automática)
Ao finalizar uma análise, salve ou atualize clients/[slug-cliente]/profile.md:
# [Nome do cliente]
## Contas ativas
| Plataforma | Account ID | Nome da conta |
|------------|------------|---------------|
| ... | ... | ... |
## KPIs acordados
- Métrica principal: [ex: ROAS 3.0x, CPL R$50]
- Período de referência: [ex: últimos 90 dias]
## Benchmarks históricos
| Métrica | Benchmark | Última leitura | Data |
|---------|-----------|---------------|------|
| ... | ... | ... | ... |
## Histórico de ações
- [Data] [Ação executada] → [Resultado observado]Troubleshooting
| Problema | Solução |
| Conector não encontrado | get_connectors para listar disponíveis |
| Campo não disponível | get_fields para mapear campos do conector |
| Sem dados no período | Ampliar período ou verificar se conta tem atividade |
| Account ID desconhecido | ads_get_ad_accounts (Meta) ou pedir ao usuário |
| Ação de escrita bloqueada | Verificar se plataforma suporta escrita via list_actions |
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.

