Communitygithub.com

Investigación de páginas de categoría

Investigación de mercado y voz del cliente para una página de ventas (página de categoría, página de aterrizaje, página de producto) en CUALQUIER mercado: EE. UU., Reino Unido, Alemania, Francia u otro país. Escanea páginas de competidores, los mejores videos de YouTube, foros (Reddit y locales), sitios de reseñas, reseñas de pacientes y el propio Confluence y Mixpanel de la empresa, y lo convierte en una lista clasificada de objeciones, los momentos que hacen que la gente actúe, cómo venden los competidores, lo que nadie hace todavía y un esqueleto de página.

¿Qué es Investigación de páginas de categoría?

Esta skill está diseñada para que la ejecute un agente de IA (por ejemplo, Claude Code, Cursor, Codex) y proporciona un proceso estructurado y reproducible para realizar una investigación exhaustiva de mercado y de voz del cliente, específicamente para la creación o rediseño de una página de ventas. Lo que la hace única es su énfasis en la procedencia y la honestidad: cada hallazgo debe estar etiquetado con su origen (leído directamente, recopilado por otra herramienta o secundario), evitando suposiciones no verificadas. La skill guía al agente a través de cuatro pasos principales: definir el alcance (mercado, categoría, objetivo de la página), crear un plan de fuentes específico para ese mercado, recopilar datos de múltiples fuentes (competidores, reseñas, videos, foros, datos propios) guardando cada una en su propio archivo, y finalmente sintetizar todo en un informe estructurado (README.md) que incluye una clasificación de objeciones, momentos de activación, cómo venden los competidores, oportunidades de mercado y un esqueleto de página. La skill también proporciona instrucciones detalladas para manejar problemas de acceso a fuentes (CAPTCHA, Reddit), cómo obtener transcripciones de YouTube y cómo redactar avisos para otras herramientas de IA (ChatGPT, Gemini, Codex) para la investigación en foros. El resultado final es una base de investigación sólida y transparente que permite tomar decisiones de diseño y contenido informadas.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Investigación de página de categoría

Investigación que termina en decisiones para una página: qué decir primero, a qué miedo responder dónde, lo que los competidores ya hacen, lo que aún está libre para tomar. Escrito después de una ejecución real para tres categorías en el mercado estadounidense (pérdida de peso, disfunción eréctil, pérdida de cabello); el método es el mismo en todos los mercados, solo cambian las fuentes.

Un principio recorre todo: cada hallazgo lleva su procedencia. Un lector debe poder distinguir "leído directamente" de "recopilado por otra herramienta, no verificado" de "una suposición". La investigación que oculta esto se cita en una página en vivo y resulta ser incorrecta.

Paso 0 — Alcance

Toma lo que la solicitud ya proporciona. Pregunta solo por lo que falta, en una sola ronda, como máximo cuatro preguntas:

  1. Mercado — país e idioma. Esto decide casi todas las fuentes.
  2. Categoría — la condición o línea de producto (de una a tres por ejecución; más se vuelve superficial).
  3. De quién es la página y qué debe hacer — marca y el trabajo de la página ("venta dura: el visitante se calienta y concluye que esto es para mí", "explicar un producto nuevo", "recuperar clientes existentes").
  4. Profundidad — exploración rápida (competidores + reseñas, aproximadamente una hora) o ejecución completa (todo lo que sigue).

Valores predeterminados cuando el usuario dice "tú decides": ejecución completa, hallazgos escritos en el idioma del usuario, citas y copia de la competencia mantenidas en el idioma original.

Paso 1 — Plan de fuentes para este mercado

Lee references/source-map.md. Enumera los tipos de fuentes y, para EE. UU., Reino Unido y Alemania, puntos de partida concretos; para cualquier otro mercado, proporciona la receta para encontrar equivalentes locales.

Escribe el plan como una tabla breve y muéstralo antes de recopilar (no esperes la aprobación a menos que el usuario haya solicitado revisarlo):

Tipo de fuenteFuentes concretas para este mercadoCómo accederé a ella
Páginas de competidores…navegador / HTML guardado
VideoYouTube, consultas en idioma localbúsqueda ordenada por vistas
Foros…solicitud ChatGPT / Gemini / Codex, o hilos pegados
Reseñas de servicios…navegador
Reseñas de pacientes / productos…navegador
Datos propiosConfluence, Mixpanelconectores

Dos cosas cambian con el mercado y son fáciles de pasar por alto:

  • El conjunto de competidores es local. Un líder estadounidense puede no operar en el país en absoluto. Encuentra quién realmente posiciona y anuncia allí (busca en el idioma local, consulta el Trustpilot local).
  • Las reglas publicitarias dan forma a las páginas. En EE. UU., una página puede nombrar el medicamento y el precio. En el Reino Unido y Alemania, los medicamentos con receta no se pueden anunciar al público, por lo que las páginas de la competencia hablan alrededor del producto y el mismo texto no se puede copiar simplemente. Nota la regla local en el plan como una pregunta para el departamento legal: no la declares como algo resuelto.

Paso 2 — Recopilar, un archivo por fuente

Lee references/collection-playbook.md antes de la primera fuente; contiene qué capturar de cada tipo de fuente y qué hacer cuando una fuente no se abre.

Trabaja en este orden: cada paso hace que el siguiente sea más nítido:

  1. Páginas de competidores. Lee todo el texto de la página, no capturas de pantalla: título, viñetas, texto del botón, orden de las secciones, cuántos productos, dónde se revela el precio real, preguntas del FAQ, notas al pie. Las bibliotecas de pantallas (Mobbin, Refero) son un complemento, nunca la investigación.
  2. Reseñas de servicios (Trustpilot o el equivalente local): calificación, número de reseñas, proporción de una estrella, temas de quejas. De aquí proviene "lo que la gente odia de los proveedores".
  3. Reseñas de pacientes o productos (Drugs.com y equivalentes locales): las reseñas más útiles por producto: resultados en las propias palabras de las personas, efectos secundarios, quién escribe.
  4. Video. Los mejores videos por vistas para las preguntas que la gente busca. Los títulos y el recuento de vistas muestran qué preguntas son las más importantes. Para lo que realmente se dice, usa las transcripciones (ver más abajo).
  5. Foros. Desencadenantes, miedos, arrepentimientos, razones para dejar de fumar. Ver "Foros" más abajo.
  6. Datos propios. Personas, vocabulario de marca e investigación previa en Confluence; comportamiento en la página existente en Mixpanel (división por dispositivo, vista → clic → pago, dónde en la página la gente hace clic).

Guarda cada fuente en su propio archivo tan pronto como se lea (competitors-live.md, reviews.md, youtube.md, forums/<category>.md, own-data.md). El contexto se compacta en ejecuciones largas; lo que no está en un archivo se pierde.

Cuando una fuente no se abre

  • Verificación de bot o CAPTCHA en un sitio de la competencia — no intentes pasarlo. Pregunta al usuario si las páginas se pueden leer a través de su propio Chrome; si es así, scripts/save_chrome_tabs.sh guarda cada página como HTML y scripts/extract_text.py lo convierte en texto legible (macOS). De lo contrario, pídeles que guarden las páginas como HTML o PDF. Si no ocurre nada de eso, marca la página como "no leída".
  • Reddit — las herramientas de navegador en Claude no pueden abrirlo, y los espejos u otras soluciones alternativas no son una opción. Usa las rutas en "Foros" más abajo.
  • La página de búsqueda de YouTube se renderiza vacía en un panel de navegador oculto: toma una captura de pantalla para forzar el renderizado, luego lee la página.
  • Cualquier otra cosa que permanezca cerrada va a la tabla de estado como "no leída", con el motivo. Una brecha que se nombra está bien; una brecha llena desde la memoria no.

Foros (Reddit y locales)

Tres rutas, en orden de preferencia:

  1. Una solicitud para ChatGPT o Gemini (modo de investigación profunda) que el PM ejecuta y pega de vuelta.
  2. Codex CLI en la terminal, si está instalado: la misma solicitud, ejecutada por Claude.
  3. Hilos que el usuario pega o exporta.

references/forum-research-prompts.md tiene la plantilla de solicitud, cómo localizarla, el comando Codex y solicitudes de seguimiento para una sola pregunta ("inyecciones o pastillas", "diario o a demanda"). Escribe la solicitud para el usuario como texto de tarea simple: qué encontrar y en qué formato.

Todo lo que provenga de otra herramienta no está verificado: las citas no fueron abiertas por ti. Etiqueta el archivo de esa manera, mantén los enlaces a los hilos y abre el enlace de una cita antes de que aparezca en una página.

Transcripciones de YouTube (pasada más profunda)

Los títulos indican qué preguntas son grandes, no qué se responde. Cuando la página necesita los argumentos reales, números o redacción de los videos, usa la skill youtube-research (https://github.com/gorelikroman/youtube-research-skill): extrae transcripciones con yt-dlp en la máquina del usuario y escribe notas citadas. Si no está instalada, ofrece:

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

Elige de 5 a 10 videos por categoría de la lista ordenada por vistas, no todos.

Paso 3 — Sintetizar

Escribe README.md en la carpeta de investigación a partir de los archivos fuente. La plantilla y las tablas están en references/output-templates.md. Las partes que más importan:

  • Tabla de estado — cada fuente, qué se tomó, qué tan confiable es.
  • Lo que la gente quiere, en sus propias palabras — el cambio de vida, no el objetivo clínico.
  • Momentos desencadenantes — el evento después del cual una persona finalmente actúa.
  • Clasificación de objeciones por categoría — cada una con cómo suena, dónde más se confirma y dónde en la página responderla.
  • Quejas sobre proveedores — y qué tiene ya tu propio producto contra cada una.
  • Cómo venden los competidores — el esqueleto compartido, las técnicas con quién las usa, lo que ocultan, lo que nadie hace.
  • Esqueleto de página — orden de bloques para esta página, con la razón de cada bloque.
  • Preguntas abiertas y brechas.

Reglas para la clasificación, porque es aquí donde la investigación a menudo exagera:

  • Una clasificación construida a partir de "con qué frecuencia aparece un tema en los hilos" es un orden, no una participación. Nunca le adjuntes porcentajes. Di en qué se basa el orden.
  • Muestra números solo donde la fuente los tenga: calificaciones de sitios de reseñas, recuentos de vistas, tasas de embudo.
  • Cuando dos fuentes no estén de acuerdo en el orden, conserva ambas y dilo.

Paso 4 — Entregar

  1. La carpeta de investigación (por defecto docs/<topic>-research/) con README.md como punto de entrada.
  2. Un breve resumen de chat: cinco o seis conclusiones, qué no está verificado, qué necesita una decisión.
  3. Si el usuario lo quiere en Figma — un informe de cuatro tableros (resumen, opiniones, clasificación de objeciones, competidores). Especificación y ayudantes de construcción: references/figma-report.md.
  4. Si el usuario quiere un wireframe — solo estructura en gris: bloques, orden, una nota por bloque que indique por qué está ahí. Sin diseño de marca a menos que se solicite. Ofrece dos o tres variantes basadas en diferentes ideas principales en lugar de una.

Reglas de honestidad

  • Etiqueta cada archivo fuente y cada cita: leído directamente / recopilado por otra herramienta / secundario.
  • Las afirmaciones médicas, legales y numéricas son propuestas. Van a los equipos médico y legal antes de cualquier página.
  • Los hallazgos de un mercado no se transfieren en silencio. Las personas escritas para Alemania son evidencia sobre Alemania; dilo cuando las uses para otro país.
  • No reproduzcas pasajes largos de reseñas o publicaciones; las citas cortas con un enlace son suficientes.
  • Mantén el lenguaje del cliente. Un miedo parafraseado en lenguaje de marketing pierde lo que lo hacía útil.

Costo

La recopilación es lectura, no razonamiento: usa el modelo capaz más barato para otras herramientas (para Codex, el modelo pequeño con bajo esfuerzo, una ejecución a la vez; las ejecuciones en paralelo en un modelo grande agotaron el límite de uso en la ejecución original). Si se usan subagentes, uno por categoría para el barrido de competidores y reseñas es suficiente; di qué hace cada uno antes de comenzarlo.

Archivos

  • references/source-map.md — tipos de fuentes y equivalentes locales por mercado
  • references/collection-playbook.md — qué capturar por fuente, problemas de acceso
  • references/forum-research-prompts.md — solicitudes para ChatGPT, Gemini, Codex
  • references/output-templates.md — diseño de carpeta, plantillas de README y tabla
  • references/figma-report.md — el informe de Figma de cuatro tableros
  • scripts/save_chrome_tabs.sh, scripts/extract_text.py — leer páginas protegidas contra bots a través del Chrome del usuario
  • scripts/run_codex_research.sh — ejecutar una solicitud de investigación a través de Codex CLI

Skills relacionados