@lucapimenta/copy-chief-black 1.0.0

package/framework/skills/audience-research-agent/references/ref_platform_mercadolivre.md

@@ -0,0 +1,236 @@
+# Extração de VOC - Mercado Livre
+
+> **Tipo de insight:** Objeções de compra, expectativas, comparações
+> **Prioridade Brasil:** Alta (produtos físicos)
+> **Linguagem:** Direta, focada em resultado, comparativa
+
+---
+
+## Por Que Mercado Livre é Essencial (BR)
+
+- Maior marketplace da América Latina
+- Seção de PERGUNTAS revela objeções PRÉ-compra
+- Avaliações revelam expectativas vs realidade
+- Público brasileiro real, linguagem natural
+- Comparações explícitas com concorrentes
+- Contexto de uso detalhado nas avaliações
+
+---
+
+## Queries de Busca (web_search)
+
+### Estrutura Base
+```
+[produto] mercado livre avaliações
+[produto] mercado livre opiniões
+[categoria] mercado livre brasil
+[produto concorrente] mercado livre
+```
+
+### Por Tipo de Insight
+
+**Para encontrar OBJEÇÕES:**
+```
+[produto] mercado livre perguntas
+[produto] vale a pena mercado livre
+[produto] funciona mercado livre
+```
+
+**Para encontrar EXPECTATIVAS:**
+```
+[produto] avaliação mercado livre
+[produto] review mercado livre brasil
+[produto] opinião compradores mercado livre
+```
+
+**Para encontrar COMPARAÇÕES:**
+```
+[produto A] vs [produto B] mercado livre
+melhor [categoria] mercado livre
+[produto] original mercado livre
+```
+
+### Exemplos por Nicho
+
+**Suplementos/Saúde:**
+```
+whey protein mercado livre avaliações
+vitamina D mercado livre opiniões
+suplemento emagrecimento mercado livre
+```
+
+**Eletrônicos:**
+```
+[produto específico] mercado livre review
+[marca] vale a pena mercado livre
+```
+
+**Beleza/Estética:**
+```
+sérum vitamina c mercado livre avaliações
+dermapen mercado livre opiniões
+minoxidil mercado livre
+```
+
+**Fitness:**
+```
+[equipamento] mercado livre avaliações
+cinta modeladora mercado livre opiniões
+```
+
+---
+
+## O Que Extrair dos Resultados
+
+### 1. Seção de PERGUNTAS (Pré-compra)
+
+**Esta é OURO para objeções!**
+
+As perguntas revelam:
+- Dúvidas antes de comprar (objeções reais)
+- Medos sobre o produto
+- Comparações que fazem
+- Critérios de decisão
+
+**Padrões de pergunta a capturar:**
+- "Funciona para [condição específica]?"
+- "É original?"
+- "Quanto tempo dura?"
+- "Tem garantia?"
+- "Qual a diferença para [concorrente]?"
+- "Serve para [uso específico]?"
+
+### 2. Avaliações NEGATIVAS (1-3 estrelas)
+
+**Prioridade máxima para dores:**
+- Expectativas não atendidas
+- Problemas de uso
+- Comparações desfavoráveis
+- Frustrações com o produto
+
+**Padrões a capturar:**
+- "Achei que ia [expectativa], mas..."
+- "Não funciona para..."
+- "O [concorrente] é melhor porque..."
+- "Dinheiro jogado fora"
+- "Propaganda enganosa"
+
+### 3. Avaliações POSITIVAS (5 estrelas)
+
+**Para entender desejos realizados:**
+- O que amaram
+- Resultados obtidos
+- Como usaram
+- Comparações favoráveis
+
+**Padrões a capturar:**
+- "Finalmente encontrei..."
+- "Muito melhor que [concorrente]..."
+- "Resolveu meu problema de..."
+- "Superou expectativas"
+
+### 4. Template de Captura
+
+```yaml
+fonte: Mercado Livre
+produto: "[nome do produto]"
+produto_url: "[URL]"
+vendedor: "[nome]"
+preco_aproximado: "[R$]"
+
+# Se for PERGUNTA:
+tipo_conteudo: pergunta
+pergunta: "[pergunta exata]"
+resposta_vendedor: "[resposta se houver]"
+insight_tipo: [objeção|dúvida|comparação|uso_específico]
+
+# Se for AVALIAÇÃO:
+tipo_conteudo: avaliação
+estrelas: [1-5]
+titulo_avaliacao: "[título se houver]"
+texto_avaliacao: "[texto completo]"
+insight_tipo: [expectativa_frustrada|resultado_positivo|comparação|problema_uso]
+
+emoção: [frustração|satisfação|surpresa|decepção]
+confidence: [alto|médio|baixo]
+```
+
+---
+
+## Estratégia de Busca por Tipo de Produto
+
+### Produtos do Seu Cliente
+1. Busque o produto exato
+2. Analise TODAS as perguntas
+3. Leia avaliações 1-3 estrelas primeiro
+4. Depois avaliações 5 estrelas
+
+### Produtos Concorrentes
+1. Identifique 3-5 concorrentes diretos
+2. Foque em avaliações negativas (dores não resolvidas)
+3. Compare padrões de reclamação
+
+### Produtos Complementares
+1. Produtos que o público também compra
+2. Revela outros problemas/desejos do mesmo público
+
+---
+
+## Padrões de Linguagem Mercado Livre
+
+### Objeções Comuns (Perguntas)
+- "É original ou réplica?"
+- "Funciona mesmo ou é enganação?"
+- "Serve pra quem tem [condição]?"
+- "Demora quanto tempo pra fazer efeito?"
+- "Tem contraindicação?"
+- "Posso usar junto com [outro produto]?"
+- "Vem com nota fiscal?"
+- "Se não funcionar posso devolver?"
+
+### Frustrações (Avaliações Negativas)
+- "Não vi resultado nenhum"
+- "Achei que ia ser diferente"
+- "Pela foto parecia maior/melhor"
+- "Muito caro pelo que entrega"
+- "Demorou muito pra chegar e veio errado"
+- "Produto veio com defeito"
+- "Vendedor não responde"
+
+### Satisfação (Avaliações Positivas)
+- "Superou minhas expectativas"
+- "Entrega rápida e produto excelente"
+- "Já é minha segunda compra"
+- "Recomendo muito"
+- "Finalmente achei um que funciona"
+- "Melhor custo-benefício"
+
+---
+
+## Análise de Concorrentes via ML
+
+### Mapeamento de Mercado
+1. Busque a categoria principal
+2. Identifique os 5 produtos mais vendidos
+3. Para cada um, analise:
+   - Perguntas mais frequentes
+   - Reclamações recorrentes
+   - Elogios recorrentes
+
+### Identificar Gaps de Mercado
+Compare avaliações negativas dos concorrentes:
+- Que problemas NINGUÉM resolve bem?
+- Que expectativa é sempre frustrada?
+- Que feature todo mundo pede?
+
+---
+
+## Checklist Mercado Livre
+
+- [ ] Produto principal analisado (perguntas + avaliações)
+- [ ] 3-5 concorrentes mapeados
+- [ ] Mínimo 20 perguntas capturadas
+- [ ] Mínimo 15 avaliações analisadas (mix de estrelas)
+- [ ] Objeções pré-compra catalogadas
+- [ ] Expectativas vs realidade mapeadas
+- [ ] Padrões de reclamação identificados

package/framework/skills/audience-research-agent/references/ref_platform_reclameaqui.md

@@ -0,0 +1,262 @@
+# Extração de VOC - Reclame Aqui
+
+> **Tipo de insight:** Dores VISCERAIS, frustrações extremas, objeções fortes
+> **Prioridade Brasil:** MUITO ALTA
+> **Linguagem:** Emocional intensa, detalhada, raivosa
+
+---
+
+## Por Que Reclame Aqui é OURO PURO
+
+- Pessoas escrevem quando estão NO AUGE DA FRUSTRAÇÃO
+- Reclamações são DETALHADAS (contexto completo)
+- Linguagem SEM FILTRO (raiva real)
+- Expectativas claramente declaradas
+- Histórico de tentativas frustradas
+- Maior plataforma de reclamações do Brasil
+- Revela EXATAMENTE o que concorrentes fazem errado
+
+**Usar Reclame Aqui para:**
+1. Mapear dores com concorrentes
+2. Identificar objeções que seu copy precisa superar
+3. Encontrar linguagem emocional autêntica
+4. Descobrir o que o mercado PROMETE mas não ENTREGA
+
+---
+
+## Queries de Busca (web_search)
+
+### Estrutura Base
+```
+[empresa concorrente] reclame aqui
+[categoria/nicho] reclame aqui
+[produto/serviço] reclamação reclame aqui
+[marca] problemas reclame aqui
+```
+
+### Por Tipo de Insight
+
+**Para encontrar DORES com concorrentes:**
+```
+[concorrente direto] reclame aqui
+[tipo de empresa] reclamações reclame aqui
+[serviço similar] reclame aqui problemas
+```
+
+**Para encontrar EXPECTATIVAS FRUSTRADAS:**
+```
+[promessa comum do nicho] não funciona reclame aqui
+[resultado prometido] propaganda enganosa reclame aqui
+```
+
+**Para encontrar PADRÕES DE MERCADO:**
+```
+[categoria] reclame aqui ranking
+[nicho] empresas reclamações
+melhores [categoria] reclame aqui
+```
+
+### Exemplos por Nicho
+
+**Infoprodutos/Cursos Online:**
+```
+[nome do curso concorrente] reclame aqui
+curso online reclame aqui
+[guru do nicho] reclame aqui
+hotmart reclame aqui [nicho]
+```
+
+**Saúde/Suplementos:**
+```
+[marca de suplemento] reclame aqui
+emagrecedor reclame aqui
+[produto específico] não funciona reclame aqui
+```
+
+**Serviços Financeiros:**
+```
+[fintech concorrente] reclame aqui
+empréstimo reclame aqui
+[banco/corretora] problemas reclame aqui
+```
+
+**E-commerce/Produtos:**
+```
+[loja concorrente] reclame aqui
+[marca] produto defeito reclame aqui
+[categoria produto] reclame aqui
+```
+
+**Clínicas/Procedimentos:**
+```
+[clínica concorrente] reclame aqui
+[procedimento estético] reclame aqui
+[franquia de saúde] reclamações
+```
+
+---
+
+## O Que Extrair dos Resultados
+
+### 1. Estrutura das Reclamações
+
+Cada reclamação geralmente contém:
+- **Título:** Resumo emocional do problema
+- **Descrição:** História completa com contexto
+- **Expectativa:** O que esperavam
+- **Realidade:** O que receberam
+- **Tentativas:** O que já tentaram resolver
+- **Pedido:** O que querem agora
+
+### 2. Elementos para Capturar
+
+**Linguagem Emocional (VERBATIM):**
+- Palavras de raiva/frustração
+- Descrições do impacto na vida
+- Comparações e expectativas
+- Ameaças e ultimatos
+
+**Padrões de Problema:**
+- Problemas que aparecem REPETIDAMENTE
+- Promessas não cumpridas recorrentes
+- Gaps de atendimento/entrega
+
+**Contexto do Cliente:**
+- Quanto pagaram
+- Há quanto tempo são clientes
+- Quantas vezes tentaram resolver
+- O que esperavam vs receberam
+
+### 3. Template de Captura
+
+```yaml
+fonte: Reclame Aqui
+empresa: "[nome da empresa]"
+empresa_url_ra: "[URL no Reclame Aqui]"
+data_reclamacao: "[data]"
+status: [resolvido|não_resolvido|em_análise]
+
+titulo_reclamacao: "[título exato]"
+texto_reclamacao: "[texto completo ou trecho relevante]"
+
+# Extração estruturada:
+expectativa_cliente: "[o que esperavam]"
+realidade_encontrada: "[o que receberam]"
+impacto_declarado: "[como afetou a vida]"
+tentativas_resolucao: "[o que já tentaram]"
+pedido_final: "[o que querem]"
+
+linguagem_emocional: ["frases de alta carga emocional"]
+tipo_problema: [produto|atendimento|entrega|promessa_falsa|cobrança]
+emoção_dominante: [raiva|decepção|desespero|indignação]
+confidence: [alto|médio|baixo]
+```
+
+---
+
+## Padrões de Linguagem Reclame Aqui
+
+### Expressões de RAIVA (capturar verbatim)
+- "Me sinto ROUBADO"
+- "GOLPE descarado"
+- "Propaganda ENGANOSA"
+- "Empresa PICARETA"
+- "Nunca mais"
+- "Vou processar"
+- "Péssimo, péssimo, péssimo"
+- "Maior arrependimento da minha vida"
+
+### Expressões de DECEPÇÃO
+- "Achei que seria diferente"
+- "Confiava na empresa"
+- "Me senti um trouxa"
+- "Promessas vazias"
+- "Esperava muito mais"
+- "Que decepção"
+
+### Expressões de DESESPERO
+- "Não sei mais o que fazer"
+- "Já tentei de tudo"
+- "Estou desesperado(a)"
+- "Preciso de ajuda"
+- "Isso está acabando comigo"
+
+### Expressões de EXPECTATIVA FRUSTRADA
+- "Prometeram X, entregaram Y"
+- "Na propaganda parecia..."
+- "Venderam uma coisa, entregaram outra"
+- "Falaram que ia... mas não..."
+
+---
+
+## Análise Estratégica de Concorrentes
+
+### Passo 1: Identificar Concorrentes
+```
+web_search("[seu nicho] empresas reclame aqui")
+web_search("[tipo de serviço] ranking reclame aqui")
+```
+
+### Passo 2: Para CADA Concorrente
+1. Acesse página da empresa no Reclame Aqui
+2. Ordene por reclamações NÃO RESOLVIDAS
+3. Identifique padrões de reclamação
+4. Capture linguagem emocional
+
+### Passo 3: Mapear Padrões Comuns
+
+Crie tabela de problemas recorrentes:
+
+| Problema | Concorrente A | Concorrente B | Concorrente C |
+|----------|---------------|---------------|---------------|
+| Entrega atrasada | ★★★ | ★★ | ★★★ |
+| Não funciona | ★★★ | ★★★ | ★★ |
+| Suporte ruim | ★★ | ★★★ | ★★★ |
+| Preço vs valor | ★★★ | ★ | ★★ |
+
+### Passo 4: Identificar Oportunidades
+
+**Perguntas estratégicas:**
+- Que problema TODOS os concorrentes têm?
+- Que promessa NINGUÉM cumpre?
+- Que expectativa é SEMPRE frustrada?
+- Que linguagem aparece em TODAS as reclamações?
+
+---
+
+## Insights Estratégicos para Copy
+
+### Objeções a Antecipar
+As reclamações revelam o que seu público TEME que aconteça:
+- "E se não funcionar para mim?"
+- "E se for igual às outras?"
+- "E se eu não conseguir suporte?"
+
+**Use no copy:** Endereçar essas objeções ANTES que surjam
+
+### Promessas a Evitar
+Se concorrentes são criticados por promessas específicas, evite fazer as mesmas ou prove que você cumpre
+
+### Garantias a Oferecer
+As reclamações revelam que garantias seriam IRRESISTÍVEIS:
+- Dinheiro de volta sem burocracia
+- Suporte que RESPONDE
+- Resultados em prazo específico
+
+### Diferenciação
+Use as falhas dos concorrentes como seu posicionamento:
+- "Diferente de [problema comum], nós..."
+- "Sabemos que você já [frustração comum]..."
+
+---
+
+## Checklist Reclame Aqui
+
+- [ ] 3-5 concorrentes diretos mapeados
+- [ ] Página de cada concorrente analisada
+- [ ] Mínimo 20 reclamações lidas em detalhe
+- [ ] Padrões de problema identificados
+- [ ] Linguagem emocional catalogada (mín 15 frases)
+- [ ] Expectativas frustradas mapeadas
+- [ ] Oportunidades de diferenciação identificadas
+- [ ] Objeções a endereçar no copy listadas

package/framework/skills/audience-research-agent/references/ref_platform_reddit.md

@@ -0,0 +1,127 @@
+# Extração de VOC - Reddit
+
+> **Tipo de insight:** Discussões profundas, linguagem sem filtro, histórias detalhadas
+> **Prioridade Brasil:** Média (menos usado no BR, mas valioso para nichos específicos)
+> **Linguagem:** Informal, detalhada, anônima = honesta
+
+---
+
+## Por Que Reddit é Valioso
+
+- Anonimato = honestidade brutal
+- Posts longos = contexto rico
+- Upvotes = validação social do sentimento
+- Subreddits = segmentação por interesse
+- Discussões aprofundadas
+
+**Limitação BR:** Reddit tem menos penetração no Brasil, mas é valioso para:
+- Nichos de tecnologia
+- Gaming
+- Finanças/investimentos
+- Comunidades de expatriados
+- Nichos com público que fala inglês
+
+---
+
+## Queries de Busca (web_search)
+
+### Estrutura Base
+```
+[problema] reddit brasil
+[nicho] reddit desabafo
+r/brasil [tema]
+[problema] help reddit
+```
+
+### Subreddits Brasileiros Relevantes
+
+**Gerais:**
+- r/brasil
+- r/desabafos
+- r/conversas
+- r/perguntereddit
+
+**Finanças:**
+- r/investimentos
+- r/farialimabets
+- r/financaspessoaispt
+
+**Tecnologia:**
+- r/brdev
+- r/programacao
+
+**Relacionamento:**
+- r/relacionamentos
+- r/sexualidade
+
+### Por Tipo de Insight
+
+**Para DORES:**
+```
+[problema] reddit desabafo
+[problema] ajuda reddit brasil
+"não aguento mais" [tema] reddit
+[problema] alguém mais reddit
+```
+
+**Para SOLUÇÕES TENTADAS:**
+```
+[solução] funciona reddit
+[solução] experiência reddit
+[solução] vale a pena reddit brasil
+já tentei [solução] reddit
+```
+
+---
+
+## O Que Extrair
+
+### Posts de Alto Valor
+- Posts com muitos upvotes
+- Posts com muitos comentários
+- Posts em subreddits de desabafo
+- Threads de discussão longas
+
+### Template de Captura
+
+```yaml
+fonte: Reddit
+subreddit: "r/[nome]"
+post_url: "[URL]"
+upvotes: [número]
+comentarios: [número]
+
+titulo_post: "[título]"
+conteudo_relevante: "[trecho ou resumo]"
+quote_verbatim: "[frase exata]"
+
+tipo: [dor|solução_tentada|pergunta|história]
+emoção: [frustração|esperança|desespero|curiosidade]
+confidence: [alto|médio|baixo]
+```
+
+---
+
+## Padrões de Linguagem Reddit BR
+
+### Indicadores de Dor
+- "Preciso desabafar..."
+- "Alguém mais passa por isso?"
+- "Não sei mais o que fazer"
+- "To no fundo do poço"
+- "Isso tá acabando comigo"
+
+### Indicadores de Busca por Solução
+- "Alguém já tentou...?"
+- "Vale a pena...?"
+- "Funciona mesmo...?"
+- "Qual a experiência de vocês com...?"
+
+---
+
+## Checklist Reddit
+
+- [ ] Subreddits relevantes identificados
+- [ ] Mínimo 5 posts analisados
+- [ ] Mínimo 10 quotes verbatim
+- [ ] Padrões de discussão mapeados