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:
- Mercado — país e idioma. Esto decide casi todas las fuentes.
- Categoría — la condición o línea de producto (de una a tres por ejecución; más se vuelve superficial).
- 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").
- 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 fuente | Fuentes concretas para este mercado | Cómo accederé a ella |
|---|---|---|
| Páginas de competidores | … | navegador / HTML guardado |
| Video | YouTube, consultas en idioma local | búsqueda ordenada por vistas |
| Foros | … | solicitud ChatGPT / Gemini / Codex, o hilos pegados |
| Reseñas de servicios | … | navegador |
| Reseñas de pacientes / productos | … | navegador |
| Datos propios | Confluence, Mixpanel | conectores |
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:
- 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.
- 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".
- 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.
- 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).
- Foros. Desencadenantes, miedos, arrepentimientos, razones para dejar de fumar. Ver "Foros" más abajo.
- 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.shguarda cada página como HTML yscripts/extract_text.pylo 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:
- Una solicitud para ChatGPT o Gemini (modo de investigación profunda) que el PM ejecuta y pega de vuelta.
- Codex CLI en la terminal, si está instalado: la misma solicitud, ejecutada por Claude.
- 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
- La carpeta de investigación (por defecto
docs/<topic>-research/) conREADME.mdcomo punto de entrada. - Un breve resumen de chat: cinco o seis conclusiones, qué no está verificado, qué necesita una decisión.
- 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. - 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 mercadoreferences/collection-playbook.md— qué capturar por fuente, problemas de accesoreferences/forum-research-prompts.md— solicitudes para ChatGPT, Gemini, Codexreferences/output-templates.md— diseño de carpeta, plantillas de README y tablareferences/figma-report.md— el informe de Figma de cuatro tablerosscripts/save_chrome_tabs.sh,scripts/extract_text.py— leer páginas protegidas contra bots a través del Chrome del usuarioscripts/run_codex_research.sh— ejecutar una solicitud de investigación a través de Codex CLI