🔵 Uso avanzado de la herramienta

Qué es

El CLI (línea de comandos) es el mismo motor de la web, pero se opera mediante texto. Destaca cuando quieres ejecutar varias empresas en secuencia, automatizar tareas, usarlo en un servidor sin pantalla o repetir un análisis con precisión.

Por qué aprender

Quien solo usa la web queda limitado a una empresa por vez, haciendo clic. El CLI desbloquea la escala y la repetibilidad: eso es lo que distingue el uso casual del profesional.

Conceptos clave

• Lotes: varias empresas en secuencia
• Automatización y uso en servidor
• Precisión: el mismo comando, el mismo resultado

Qué es

El comando central es python -m strategy_factory.main run "Stripe". Activa las 3 fases y crea la carpeta output/stripe con todo: documentos, presentaciones, Word y diagramas.

Por qué aprender

Es el comando que más vas a usar. Todas las opciones que veremos a continuación son variantes de este. Dominar el run es dominar el 90% de la herramienta.

Conceptos clave

• run "Empresa" = pipeline completo
• El nombre entre comillas se convierte en la carpeta output/slug
• Activa siempre el venv antes de ejecutar

Qué es

Agrega --context "B2B payments, fintech" para dar contexto a la investigación. Esto orienta a Perplexity y mejora la calidad de los 15 documentos.

Por qué aprender

Para empresas poco conocidas o con nombres ambiguos, el contexto marca toda la diferencia: evita que la IA investigue la empresa equivocada.

Conceptos clave

• --context = sector, modelo, tamaño
• Texto libre entre comillas
• Opcional, pero recomendado

Qué es

Usa --mode quick (el estándar) para una pasada rápida y barata, o --mode comprehensive para una investigación más profunda y más costosa.

Por qué aprender

Es la opción que más influye en el costo y el tiempo. El Módulo 2.2 completo está dedicado a ella; aquí basta con saber que existe y qué hace cada valor.

Conceptos clave

• quick = estándar, ~9 búsquedas
• comprehensive = ~18 búsquedas, más profundo
• Los 15 documentos son los mismos en ambos

Qué es

Con --dry-run, la herramienta simula la ejecución y muestra lo que se generaría, sin hacer ninguna llamada de IA — es decir, sin costo.

Por qué aprender

Es la mejor forma de probar la instalación y las claves antes de gastar de verdad. Si el dry-run se ejecuta sin errores, tu configuración es correcta.

Conceptos clave

• --dry-run = simulación, costo cero
• Muestra el plan de ejecución
• Ideal para validar la configuración

Qué es

El comando status "Stripe" --detailed muestra el progreso y el costo de un análisis; list lista todas las empresas ya analizadas.

Por qué aprender

Son tus comandos de inspección: descubrir qué ya se hizo, cuánto costó y qué falta — sin volver a abrir cada carpeta a mano.

Conceptos clave

• status "Empresa" --detailed = progreso + costo
• list = todos los análisis realizados
• No consumen API; son lectura local

Qué es

resume "Stripe" retoma desde donde te quedaste; reset "Stripe" --yes lo limpia todo; y las flags --skip-research, --skip-synthesis e --skip-generation reutilizan resultados ya guardados en caché.

Por qué aprender

Son tus comandos de recuperación y ahorro: nunca repitas (ni vuelvas a pagar) una etapa que ya salió bien. Volvemos a ellos en el Módulo 2.3.

Conceptos clave

• resume = continúa lo que quedó pendiente
• reset --yes = empieza desde cero
• --skip-* = omite fases que ya están en caché

Qué es

La diferencia está en la profundidad de la investigación: el modo Quick hace unas 9 búsquedas; el Comprehensive, unas 18. Los 15 documentos generados son exactamente los mismos: lo que cambia es la riqueza de la materia prima.

Por qué aprender

Saber que el resultado es el mismo desmonta un mito común: Comprehensive no genera "más documentos", sino documentos mejor fundamentados.

Conceptos clave

• Quick ≈ 9 búsquedas
• Comprehensive ≈ 18 búsquedas
• Los mismos 15 documentos en ambos

Qué es

El modo predeterminado. Tarda de 2 a 3 minutos y cuesta cerca de US$ 0,05 por empresa. Es una pasada rápida, ideal para obtener una primera visión y evaluar varias empresas.

Por qué aprender

Como es barato y rápido, es el punto de partida natural. Puedes evaluar muchas empresas por unos pocos centavos antes de profundizar en las que importan.

Conceptos clave

• Es el valor predeterminado (sin necesidad de opción)
• 2-3 min · ~US$ 0,05
• Úsala para filtrar y hacer una primera revisión

Qué es

El análisis profundo. Toma de 5 a 10 minutos y cuesta cerca de US$ 0,50 por empresa. La investigación es más amplia y detallada: ideal para la empresa que realmente vas a presentar.

Por qué aprender

Cuando el resultado se entrega a un cliente o a la directiva, vale la pena pagar 10x más (aun así, centavos) para tener el mejor respaldo posible.

Conceptos clave

• --mode comprehensive
• 5-10 min · ~US$ 0,50
• Úsala en la empresa que vas a presentar

Qué es

En Quick, la investigación usa solo el modelo sonar (barato y rápido). En Comprehensive, combina sonar + sonar-pro + sonar-deep-research. La síntesis, en ambos casos, siempre usa Gemini gemini-2.5-flash.

Por qué aprender

Entender qué modelos se usan en cada modo explica por qué Comprehensive cuesta más: usa modelos más caros y potentes para la investigación.

Conceptos clave

• Quick = sonar
• Comprehensive = sonar + sonar-pro + deep-research
• Síntesis siempre = gemini-2.5-flash

Qué es

En la práctica: Quick cuesta entre ~US$ 0,02 y US$ 0,15; Comprehensive, entre ~US$ 0,31 y US$ 0,90. La fase de generación (local) siempre es gratuita.

Por qué aprender

Incluso el modo más caro cuesta menos de un dólar. Ver las cifras lado a lado muestra que lo «caro» aquí sigue siendo baratísimo en comparación con una consultoría.

Conceptos clave

• Quick ~US$ 0,02-0,15
• Comprehensive ~US$ 0,31-0,90
• Generación local = gratis

Qué es

La estrategia ganadora: filtrar varias empresas en Quick y luego ejecutar la elegida en Comprehensive. Si ya tienes la investigación básica, usa --skip-research para no volver a pagar.

Por qué aprender

Es el flujo que equilibra costo y calidad: solo gastas en lo caro cuando vale la pena, después de filtrar con lo barato.

Conceptos clave

• Clasifica en Quick y profundiza en Comprehensive
• Árbol de decisión simple: ¿vas a presentar? → comprehensive
• --skip-research evita repetir la investigación

Qué es

En la primera fase, Perplexity realiza de 9 a 18 búsquedas sobre la empresa: descripción general, stack tecnológico, competidores, problemas y regulación. Todo se recopila y guarda para las fases siguientes.

Por qué aprender

Es la materia prima de todo. Sin una buena investigación, los documentos quedan débiles; por eso el contexto y el modo son tan importantes.

Conceptos clave

• 9-18 búsquedas según el modo
• Cubre empresa, sector, competidores y regulación
• Resultado guardado para reutilizar

Qué es

En la segunda fase, Gemini genera los 15 documentos en orden de dependencia — algunos solo se escriben cuando otros están listos. Hay una pausa de ~5s entre las llamadas para respetar los límites de la API.

Por qué aprender

Entender el orden explica por qué la fase tarda un poco y por qué no se puede generar todo de una vez: un documento usa el anterior como insumo.

Conceptos clave

• 15 documentos en orden de dependencia
• Pausa de ~5s entre llamadas
• Respeta el límite de solicitudes de Gemini

Qué es

La tercera fase se ejecuta en tu computadora, sin costo: crea los 2 PPTX (con la biblioteca python-pptx), los 2 DOCX y renderiza los diagramas Mermaid en PNG (usando Chrome/Puppeteer internamente).

Por qué aprender

Por eso el costo total es tan bajo: la parte que se convierte en «archivos bonitos» no consume ninguna API; todo se hace localmente.

Conceptos clave

• PPTX mediante python-pptx
• DOCX y diagramas PNG
• Mermaid renderizado con Chrome/Puppeteer

Qué es

O state.json es el punto de control del análisis: guarda la fase actual, los entregables que ya están listos, el costo acumulado y los errores encontrados.

Por qué aprender

Es exactamente este archivo el que permite el comando resume: sin él, la herramienta no sabría desde dónde continuar.

Conceptos clave

• Guarda la fase, los entregables listos, el costo y los errores
• Es lo que hace posible el resume
• Queda en la carpeta de la empresa

Qué es

O research_cache.json guarda la investigación sin procesar de Perplexity. Con él, puedes volver a generar los documentos sin investigar de nuevo, usando --skip-research.

Por qué aprender

Es tu mayor aliado para ahorrar: la investigación es la parte que cuesta. Reutilizarla significa ajustar y volver a generar documentos casi gratis.

Conceptos clave

• Guarda la investigación sin procesar de Perplexity
• --skip-research reutiliza esta caché
• Volver a generar documentos sin pagar otra vez por la investigación

Qué es

Si interrumpes el proceso con Ctrl+C o se cae internet, basta con ejecutar resume "Empresa" para continuar desde donde te quedaste. Si aparece un error 429 (límite de solicitudes), espera unos minutos y retoma.

Por qué aprender

Los fallos ocurren. Saber cómo recuperarte sin perder el trabajo (ni el dinero ya gastado) es lo que hace que el uso diario sea tranquilo.

Conceptos clave

• resume continúa desde donde se quedó
• Error 429 = límite alcanzado → esperar y reanudar
• state.json conserva el progreso

Qué es

Cada empresa se convierte en una carpeta output/{slug}/ con subcarpetas: markdown/ (15 .md), presentations/ (2 .pptx), documents/ (2 .docx), mermaid_images/ (5 .png), además de state.json e research_cache.json.

Por qué aprender

Conocer la estructura te permite encontrar cualquier archivo al instante y entender qué es cada uno. La Ruta 3 abre el contenido de cada entregable.

Conceptos clave

• output/{slug}/ por empresa
• markdown, presentations, documents, mermaid_images
• + state.json y research_cache.json