agentleFS
lucaspaesbrazil-lablucaspaesbrazil-lab/agencia-digital-showcase/.claude/skills/organic-audit/SKILL.md

organic-audit

Skill0 starsChanged 4 months agoMITView on GitHub

Agente de auditoria de tráfego orgânico (Instagram, Facebook, YouTube, TikTok, LinkedIn, Google My Business, Search Console) com acesso ao vivo via Windsor.ai MCP. Use quando o usuário pedir para auditar/diagnosticar performance orgânica, redes sociais, SEO ou presença digital — "audita meu Instagram", "como está meu SEO", "diagnóstico do canal do YouTube", "performance orgânica do cliente".

The file

Files
SKILL.md

Organic Audit — Auditoria de Tráfego Orgânico

Espelha o workflow de campaign-audit (mídia paga), adaptado para canais orgânicos. Prioriza dados ao vivo via Windsor.ai; aceita CSV/print como fallback quando o conector não está disponível.

Quando usar esta skill

Ativar quando o usuário:

  • Pedir auditoria/diagnóstico de canal orgânico ("audita meu Instagram", "como está o SEO")
  • Solicitar performance de conteúdo orgânico (alcance, engajamento, crescimento de seguidores)
  • Pedir diagnóstico de Search Console / GA4 no lado orgânico (impressões de busca, posição média, CTR orgânico)
  • Mencionar YouTube, TikTok orgânico, LinkedIn orgânico, Google My Business

Não usar para: análise de mídia paga (usar ads-analyst/campaign-audit) ou engenharia reversa de posts de referência/concorrente (usar skill global agente-social-media + subagente analista-referencias).

ETAPA 1 — Contexto obrigatório

Antes de qualquer chamada MCP, confirme com o usuário:

1. Qual cliente?
2. Qual(is) canal(is)? (Instagram / Facebook / YouTube / TikTok / LinkedIn / Google My Business / Search Console)
3. Qual período? (padrão sugerido: últimos 30 dias vs 30 dias anteriores)
4. Qual o foco?
   - Visão geral de crescimento e engajamento
   - Diagnóstico (o que está travando o crescimento?)
   - SEO / performance de busca
   - Comparativo de período

Se 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 contexto (handles/contas, pilares de conteúdo, benchmarks históricos, calendário editorial vigente).

ETAPA 2 — Verificar conexão MCP e conectores

Windsor.ai: get_current_user → confirmar usuário autenticado
Windsor.ai: get_connectors → listar plataformas disponíveis

Connector IDs orgânicos (ver .claude/rules/mcp-data-guide.md):

Canalconnector_id
Instagram (orgânico)instagram_public
Facebook (orgânico)facebook_organic
YouTubeyoutube
TikTok (orgânico)tiktok_organic
LinkedIn (orgânico)linkedin_organic
Google My Businessgoogle_my_business
Google Search Consolegoogle_search_console
Google Analytics 4 (tráfego orgânico)googleanalytics4

Se o conector solicitado não estiver disponível, informe o usuário e pergunte se deseja fornecer dados manualmente (CSV, print de insights, ou export nativo da plataforma).

ETAPA 3 — Mapear campos disponíveis

Windsor.ai: get_fields(connector_id="[canal]")

Campos recomendados por objetivo:

Instagram / Facebook / LinkedIn orgânico — crescimento e engajamento

dimensions: ["post_id" ou "date"]
fields: [
  "impressions", "reach", "engagement", "engagement_rate",
  "likes", "comments", "shares", "saves",
  "followers", "follower_growth", "profile_views"
]

YouTube — retenção e descoberta

dimensions: ["video_id" ou "date"]
fields: [
  "views", "watch_time", "average_view_duration",
  "subscribers_gained", "impressions", "impressions_ctr", "traffic_source"
]

TikTok orgânico

dimensions: ["post_id" ou "date"]
fields: [
  "video_views", "video_completion_rate", "reach",
  "likes", "comments", "shares", "followers"
]

Google Search Console — SEO

dimensions: ["query" ou "page"]
fields: [
  "clicks", "impressions", "ctr", "position"
]

Google My Business — presença local

fields: [
  "views_search", "views_maps", "calls", "direction_requests", "website_clicks"
]

ETAPA 4 — Extrair dados

Windsor.ai: get_data(
  connector_id = "[canal]"
  date_range   = { start: "YYYY-MM-DD", end: "YYYY-MM-DD" }
  fields       = [métricas relevantes conforme objetivo]
  dimensions   = [nível desejado: post / vídeo / query / data]
  filters      = { account_id: "[handle ou ID]" }  ← sempre filtrar por conta
)

Sempre puxar período atual E período anterior equivalente para calcular variação %.

ETAPA 5 — Análise (adaptação da sequência de analysis-frameworks.md §9)

5.1 — Mensuração

  • GA4 e Search Console configurados corretamente e recebendo dados?
  • Conversões/eventos de origem orgânica sendo atribuídos corretamente?
  • Se impossível verificar, sinalizar como ponto cego (⚠️).

5.2 — Estrutura

  • Calendário editorial e pilares de conteúdo definidos e sendo seguidos?
  • Cadência de publicação consistente por canal (comparar planejado vs realizado)?

5.3 — Públicos

  • Alinhamento entre audiência orgânica (dados demográficos/interesses) e ICP do cliente?
  • Taxa de seguidores não-engajados ou crescimento artificial (picos sem correlação com conteúdo)?

5.4 — Criativos

  • Aplicar HSO Score (analysis-frameworks.md §6) nos top 5 e bottom 5 posts do período.
  • Identificar formatos/temas com melhor e pior desempenho relativo.

5.5 — Distribuição

  • Cadência de publicação por canal está de acordo com o calendário editorial?
  • Há concentração excessiva em um único formato ou canal?

5.6 — Tendência

  • Comparar período atual vs anterior (mesmo número de dias).
  • Calcular variação % em alcance, engajamento, seguidores, cliques de busca.
  • Identificar se é crescimento, queda ou platô.

5.7 — Anomalias (adaptado de analysis-frameworks.md §3)

CondiçãoSinal
Alcance ou engajamento varia > 30% vs período anterior🔴
Queda de seguidores por 3+ dias consecutivos🔴
CTR de busca (Search Console) cai > 40% sem queda de impressões🔴 Canibalização ou penalização
Posição média piora > 5 posições em query relevante🟡
Engagement rate < 1/3 da média histórica da conta🟡 Fadiga de conteúdo
Nenhuma publicação em 7+ dias com calendário ativo🟡 Problema de execução

5.8 — Classificação com semáforo

  • 🟢 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 (segue .claude/rules/output-standards.md):

## Análise Orgânica — [Cliente] | [Canal(is)] | [Período]
*Gerado em: [data] | Fonte: [Windsor.ai / dados manuais]*

### Resumo Executivo
[2-3 linhas: o que está funcionando, o que está travando o crescimento, ação urgente se houver]

### Performance por Canal

| Canal | Alcance | Engajamento | Seguidores (Δ) | 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]

Regras de segurança

  • NUNCA comparar benchmark orgânico entre nichos diferentes sem normalização.
  • NUNCA recomendar aumento de cadência de publicação sem antes diagnosticar qualidade/engajamento.
  • Esta skill é somente leitura — não há ação de escrita disponível para conectores orgânicos via MCP no momento.

Perfil de cliente (memória automática)

Ao finalizar uma análise, salve ou atualize clients/[slug-cliente]/profile.md:

## Canais orgânicos ativos
| Canal | Handle/ID | Pilares de conteúdo |
|-------|-----------|----------------------|
| ...   | ...       | ...                  |

## Benchmarks orgânicos históricos
| Métrica | Benchmark | Última leitura | Data |
|---------|-----------|-----------------|------|
| ...     | ...       | ...             | ...  |

Troubleshooting

ProblemaSolução
Conector não encontradoget_connectors para listar disponíveis
Campo não disponívelget_fields para mapear campos do conector
Sem dados no períodoAmpliar período ou pedir export manual da plataforma
Handle/ID de conta desconhecidoPedir ao usuário o handle exato ou ID da página/perfil

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.