Communitygithub.com

pesquisa-de-pagina-de-categoria

Pesquisa de mercado e voz do cliente para uma página de vendas (página de categoria, landing page, página de produto) em QUALQUER mercado — EUA, Reino Unido, Alemanha, França ou outro país. Varre páginas de concorrentes, principais vídeos do YouTube, fóruns (Reddit e locais), sites de avaliações, avaliações de pacientes e o próprio Confluence e Mixpanel da empresa, depois transforma isso em uma lista classificada de objeções, os momentos que fazem as pessoas agirem, como os concorrentes vendem, o que ninguém faz ainda e um esqueleto de página.

O que é pesquisa-de-pagina-de-categoria?

Esta skill orienta a realização de pesquisa de mercado e voz do cliente (VOC) para páginas de vendas, como páginas de categoria, landing pages e páginas de produto, em qualquer mercado global. Ela fornece uma metodologia completa que começa com a definição do escopo (mercado, categoria, objetivo da página) e, em seguida, orienta a coleta sistemática de dados de diversas fontes, incluindo páginas de concorrentes, YouTube, fóruns, sites de avaliações e dados internos (Confluence e Mixpanel). A skill é projetada para profissionais como gerentes de produto e designers que precisam de uma base de pesquisa sólida antes de criar ou otimizar uma página. O resultado principal é um resumo sintetizado (README.md) que inclui uma classificação de objeções, momentos de gatilho, análise competitiva e um esqueleto de página. Um princípio fundamental é a transparência: cada descoberta deve ter sua origem claramente identificada (lida diretamente vs. coletada por outra ferramenta vs. suposição), evitando que informações não verificadas sejam usadas em páginas ao vivo. A skill oferece suporte a tarefas comuns, como 'pesquise o mercado para X', 'analise os concorrentes' e 'preparar pesquisa para a página de categoria', e lida com fontes de difícil acesso usando scripts auxiliares e prompts para outras ferramentas de IA.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/gorelikroman/category-page-research-skill/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pesquisa de página de categoria

Pesquisa que termina em decisões para uma página: o que dizer primeiro, qual medo responder onde, o que os concorrentes já fazem, o que ainda está livre para ser usado. Escrito após uma execução real para três categorias no mercado dos EUA (perda de peso, disfunção erétil, queda de cabelo); o método é o mesmo em todos os mercados, apenas as fontes mudam.

Um princípio percorre tudo: cada descoberta carrega sua proveniência. Um leitor deve ser capaz de distinguir "lido diretamente" de "coletado por outra ferramenta, não verificado" de "um palpite". Uma pesquisa que esconde isso acaba sendo citada em uma página ao vivo e se revela errada.

Etapa 0 — Escopo

Pegue o que a solicitação já fornece. Pergunte apenas o que está faltando, em uma única rodada, no máximo quatro perguntas:

  1. Mercado — país e idioma. Isso decide quase todas as fontes.
  2. Categoria — a condição ou linha de produto (uma a três por execução; mais fica superficial).
  3. Qual página e o que ela deve fazer — marca e a função da página ("venda difícil: o visitante se aquece e conclui que isso é para mim", "explicar um novo produto", "reconquistar clientes existentes").
  4. Profundidade — varredura rápida (concorrentes + avaliações, cerca de uma hora) ou execução completa (tudo abaixo).

Padrões quando o usuário diz "você decide": execução completa, descobertas escritas no idioma do usuário, citações e cópia do concorrente mantidas no idioma original.

Etapa 1 — Plano de fontes para este mercado

Leia references/source-map.md. Ele lista os tipos de fonte e, para os EUA, Reino Unido e Alemanha, pontos de partida concretos; para qualquer outro mercado, fornece a receita para encontrar equivalentes locais.

Escreva o plano como uma tabela curta e mostre-a antes de coletar (não espere aprovação, a menos que o usuário tenha pedido para revisá-la):

Tipo de fonteFontes concretas para este mercadoComo vou acessá-la
Páginas de concorrentes…navegador / HTML salvo
VídeoYouTube, consultas no idioma localpesquisa ordenada por visualizações
Fóruns…prompt do ChatGPT / Gemini / Codex, ou tópicos colados
Avaliações de serviço…navegador
Avaliações de pacientes / produtos…navegador
Dados própriosConfluence, Mixpanelconectores

Duas coisas mudam com o mercado e são fáceis de perder:

  • O conjunto de concorrentes é local. Um líder dos EUA pode nem operar no país. Encontre quem realmente ranqueia e anuncia lá (pesquise no idioma local, verifique o Trustpilot local).
  • As regras de publicidade moldam as páginas. Nos EUA, uma página pode nomear o medicamento e o preço. No Reino Unido e na Alemanha, medicamentos sob prescrição não podem ser anunciados ao público, então as páginas dos concorrentes contornam o produto e o mesmo texto não pode ser simplesmente copiado. Anote a regra local no plano como uma pergunta para o jurídico — não a declare como definitiva.

Etapa 2 — Coletar, um arquivo por fonte

Leia references/collection-playbook.md antes da primeira fonte; ele tem o que capturar de cada tipo de fonte e o que fazer quando uma fonte não abrir.

Trabalhe nesta ordem — cada etapa torna a próxima mais nítida:

  1. Páginas de concorrentes. Leia o texto completo da página, não capturas de tela: título, marcadores, texto do botão, ordem das seções, quantos produtos, onde o preço real é divulgado, perguntas do FAQ, notas de rodapé. Bibliotecas de telas (Mobbin, Refero) são um suplemento, nunca a pesquisa.
  2. Avaliações de serviço (Trustpilot ou equivalente local): classificação, número de avaliações, parcela de uma estrela, temas de reclamação. É daí que vem "o que as pessoas odeiam nos provedores".
  3. Avaliações de pacientes ou produtos (Drugs.com e equivalentes locais): as avaliações mais úteis por produto — resultados nas próprias palavras das pessoas, efeitos colaterais, quem está escrevendo.
  4. Vídeo. Principais vídeos por visualizações para as perguntas que as pessoas pesquisam. Títulos e contagens de visualizações mostram quais perguntas são maiores. Para o que é realmente dito, use as transcrições (veja abaixo).
  5. Fóruns. Gatilhos, medos, arrependimentos, motivos para desistir. Veja "Fóruns" abaixo.
  6. Dados próprios. Personas, vocabulário da marca e pesquisas anteriores no Confluence; comportamento na página existente no Mixpanel (divisão por dispositivo, visualização → clique → pagamento, onde na página as pessoas clicam).

Salve cada fonte em seu próprio arquivo assim que for lida (competitors-live.md, reviews.md, youtube.md, forums/<category>.md, own-data.md). O contexto é compactado em execuções longas; o que não está em um arquivo é perdido.

Quando uma fonte não abrir

  • Verificação de bot ou CAPTCHA em um site concorrente — não tente contorná-lo. Pergunte ao usuário se as páginas podem ser lidas através do próprio Chrome dele; se sim, scripts/save_chrome_tabs.sh salva cada página como HTML e scripts/extract_text.py a transforma em texto legível (macOS). Caso contrário, peça para ele salvar as páginas como HTML ou PDF. Se nenhum dos dois acontecer, marque a página como "não lida".
  • Reddit — as ferramentas do navegador no Claude não conseguem abri-lo, e mirrors ou outras soluções alternativas não são uma opção. Use as rotas em "Fóruns" abaixo.
  • A página de pesquisa do YouTube é renderizada vazia em um painel de navegador oculto — tire uma captura de tela para forçar a renderização, depois leia a página.
  • Qualquer outra coisa que permaneça fechada vai para a tabela de status como "não lida", com o motivo. Uma lacuna que é nomeada é aceitável; uma lacuna preenchida de memória não é.

Fóruns (Reddit e locais)

Três rotas, em ordem de preferência:

  1. Um prompt para o ChatGPT ou Gemini (modo de pesquisa profunda) que o PM executa e cola de volta.
  2. Codex CLI no terminal, se instalado — mesmo prompt, executado pelo Claude.
  3. Tópicos que o usuário cola ou exporta.

references/forum-research-prompts.md tem o modelo de prompt, como localizá-lo, o comando Codex e prompts de acompanhamento para uma única pergunta ("injeções ou pílulas", "diário ou sob demanda"). Escreva o prompt para o usuário como texto de tarefa simples — o que encontrar e em qual formato.

O que quer que volte de outra ferramenta não está verificado: as citações não foram abertas por você. Rotule o arquivo dessa forma, mantenha os links dos tópicos e abra o link de uma citação antes de colocá-la em uma página.

Transcrições do YouTube (passagem mais profunda)

Os títulos dizem quais perguntas são grandes, não o que é respondido. Quando a página precisar dos argumentos reais, números ou texto dos vídeos, use a skill youtube-research (https://github.com/gorelikroman/youtube-research-skill): ela extrai transcrições com yt-dlp na máquina do usuário e escreve notas citadas. Se não estiver instalada, ofereça:

git clone https://github.com/gorelikroman/youtube-research-skill ~/.claude/skills/youtube-research

Escolha 5 a 10 vídeos por categoria da lista dos mais vistos, não todos.

Etapa 3 — Sintetizar

Escreva README.md na pasta de pesquisa a partir dos arquivos de fonte. O modelo e as tabelas estão em references/output-templates.md. As partes que mais importam:

  • Tabela de status — cada fonte, o que foi extraído, o nível de confiança.
  • O que as pessoas querem, em suas palavras — a mudança de vida, não o objetivo clínico.
  • Momentos de gatilho — o evento após o qual uma pessoa finalmente age.
  • Classificação de objeções por categoria — cada uma com como soa, onde mais é confirmada e onde na página respondê-la.
  • Reclamações sobre provedores — e o que seu próprio produto já tem contra cada uma.
  • Como os concorrentes vendem — o esqueleto compartilhado, as técnicas com quem as usa, o que escondem, o que ninguém faz.
  • Esqueleto da página — ordem dos blocos para esta página, com o motivo de cada bloco.
  • Perguntas em aberto e lacunas.

Regras para a classificação, porque é onde a pesquisa mais frequentemente exagera:

  • Uma classificação construída a partir de "com que frequência um tema aparece nos tópicos" é uma ordem, não uma parcela. Nunca anexe porcentagens a ela. Diga em que a ordem se baseia.
  • Mostre números apenas onde a fonte os tem: classificações de sites de avaliação, contagens de visualizações, taxas de funil.
  • Quando duas fontes discordarem sobre a ordem, mantenha ambas e diga isso.

Etapa 4 — Entregar

  1. A pasta de pesquisa (padrão docs/<topic>-research/) com README.md como ponto de entrada.
  2. Um breve resumo no chat: cinco ou seis conclusões, o que não está verificado, o que precisa de uma decisão.
  3. Se o usuário quiser no Figma — um relatório de quatro quadros (resumo, opiniões, classificação de objeções, concorrentes). Especificação e auxiliares de construção: references/figma-report.md.
  4. Se o usuário quiser um wireframe — apenas estrutura cinza: blocos, ordem, uma nota por bloco dizendo por que está lá. Nenhum design de marca, a menos que solicitado. Ofereça duas ou três variantes construídas em diferentes ideias principais, em vez de uma.

Regras de honestidade

  • Rotule cada arquivo de fonte e cada citação: lido diretamente / coletado por outra ferramenta / secundário.
  • Alegações médicas, legais e numéricas são propostas. Elas vão para as equipes médica e jurídica antes de qualquer página.
  • Descobertas de um mercado não se transferem silenciosamente. Personas escritas para a Alemanha são evidências sobre a Alemanha; diga isso ao usá-las para outro país.
  • Não reproduza longas passagens de avaliações ou posts; citações curtas com um link são suficientes.
  • Mantenha a linguagem do cliente. Um medo parafraseado em jargão de marketing perde o que o tornou útil.

Custo

Coleta é leitura, não raciocínio: use o modelo capaz mais barato para outras ferramentas (para Codex, o modelo pequeno com baixo esforço, uma execução por vez — execuções paralelas em um modelo grande queimaram o limite de uso na execução original). Se subagentes forem usados, um por categoria para a varredura de concorrentes e avaliações é suficiente; diga o que cada um faz antes de iniciá-lo.

Arquivos

  • references/source-map.md — tipos de fonte e equivalentes locais por mercado
  • references/collection-playbook.md — o que capturar por fonte, problemas de acesso
  • references/forum-research-prompts.md — prompts para ChatGPT, Gemini, Codex
  • references/output-templates.md — layout da pasta, modelos de README e tabela
  • references/figma-report.md — o relatório Figma de quatro quadros
  • scripts/save_chrome_tabs.sh, scripts/extract_text.py — ler páginas protegidas contra bot através do Chrome do usuário
  • scripts/run_codex_research.sh — executar um prompt de pesquisa através do Codex CLI

Habilidades Relacionadas