Documentación de la GUI

Guías paso a paso para usar las aplicaciones de escritorio de Windows y macOS

Primeros Pasos con la GUI

Al iniciar la aplicación GUI, verás una ventana con tema oscuro compuesta por:

  • Área de salida (arriba): muestra los resultados, mensajes y progreso del rastreo con salida codificada por colores
  • Campo de entrada (abajo): escribe aquí los comandos con autocompletado inteligente
  • Botón Submit: haz clic o presiona Enter para ejecutar los comandos

Funciones Clave

  • Historial de Comandos: usa las teclas de flecha arriba/abajo para navegar por los comandos anteriores
  • Autocompletado: presiona Tab para completar los comandos mientras escribes
  • Diálogos Nativos: selectores de archivos y carpetas para elegir rutas fácilmente
  • Retroalimentación en Tiempo Real: salida codificada por colores (errores en rojo, éxitos en verde, advertencias en amarillo)
  • Gestión de Configuración: guarda y carga ajustes específicos de cada proyecto

Ejemplos de Flujos de Trabajo

Ejemplo 1: Auditoría Simple de un Sitio Web

Perfecto para revisiones rápidas del estado SEO

> set url https://mywebsite.com
URL set to: https://mywebsite.com

> set output-dir
[Folder browser opens - select a directory]
Output directory set to: C:\Reports\MyWebsite
Vector database path automatically set to: C:\Reports\MyWebsite\vector.db

> set output-type html-folder
Output type set to: html-folder

> crawl
Starting crawl of https://mywebsite.com...
[Real-time progress displayed]
Crawl completed: 47 pages analyzed
Report saved to: C:\Reports\MyWebsite\

Ejemplo 2: Revisión Técnica Rápida (50 Páginas)

Análisis rápido del SEO técnico del sitio con límite de páginas

> set url https://example.com
URL set to: https://example.com

> set max-pages 50
Max pages set to: 50

> set concurrent-requests 10
Concurrent requests set to: 10

> set output-type json
Output type set to: json

> crawl
Starting crawl (max 50 pages)...
[Progress updates]
Crawl completed: 50 pages analyzed

Ejemplo 3: Análisis de Aplicación de Una Sola Página (SPA)

Analiza sitios web con mucho JavaScript con renderizado adecuado

> set url https://spa-app.com
URL set to: https://spa-app.com

> set spa true
SPA mode enabled

> set output-type html-folder
Output type set to: html-folder

> crawl
Starting SPA crawl with JavaScript rendering...
[Progress updates]
SPA crawl completed: 23 pages analyzed

Ejemplo 4: Análisis de Sitemap

Rastrea todas las URLs de un archivo sitemap.xml

> set url https://example.com/sitemap.xml
URL set to: https://example.com/sitemap.xml

> set is-sitemap true
Sitemap mode enabled

> crawl
Parsing sitemap...
Found 142 URLs in sitemap
Starting crawl...
[Progress updates]
Sitemap crawl completed: 142 pages analyzed

Ejemplo 5: Análisis Competitivo con IA

Analiza a la competencia con insights impulsados por OpenAI

> set url https://competitor.com
URL set to: https://competitor.com

> set openai-api-key sk-proj-xxxxxxxxxxxxx
OpenAI API key set
OpenAI analyzer automatically enabled

> set openai-model gpt-4o
OpenAI model set to: gpt-4o

> set openai-prompt Analyze this site's SEO strategy and content quality
OpenAI prompt set

> set max-pages 30
Max pages set to: 30

> crawl
Starting crawl with AI analysis...
[Crawl progress]
[AI analysis results displayed]
Crawl completed with AI insights

Ejemplo 6: Uso de Prompts Personalizados de IA

Carga prompts desde archivos para un análisis consistente

> set url https://example.com
URL set to: https://example.com

> set anthropic-api-key sk-ant-xxxxxxxxxxxxx
Anthropic API key set
Anthropic analyzer automatically enabled

> set anthropic-model claude-3-5-sonnet-20241022
Anthropic model set to: claude-3-5-sonnet-20241022

> set anthropic-prompt-file C:\Prompts\detailed-seo-audit.txt
Anthropic prompt loaded from file

> crawl
Starting crawl with Claude analysis...
[Progress and AI insights]

Ejemplo 7: Revisión de Rastreos Anteriores

Accede y exporta datos de rastreos anteriores desde la base de datos

> list crawls
Crawl Database: C:\Reports\crawl.db

ID  | Session ID                           | URL                    | Start Time          | Pages
----|--------------------------------------|------------------------|---------------------|------
1   | abc123-def456-ghi789                 | https://site1.com      | 2026-02-10 14:30:00 | 127
2   | xyz789-uvw456-rst123                 | https://site2.com      | 2026-02-12 09:15:00 | 89
3   | mno345-pqr678-stu901                 | https://site3.com      | 2026-02-14 16:45:00 | 234

> export abc123-def456-ghi789 html-folder
Exporting crawl session: abc123-def456-ghi789
Output type: html-folder
Export completed: C:\Reports\site1-export\

Ejemplo 8: Gestión de Configuración

Guarda y carga ajustes específicos de cada proyecto

> show config
Current Configuration:
  url: https://example.com
  output-dir: C:\Reports
  output-type: html-folder
  concurrent-requests: 10
  rate-limit: 50
  max-pages: 100
  [... more settings ...]

> save my-project-config.json
[Save dialog opens]
Configuration saved to: C:\Configs\my-project-config.json

[Later session...]
> load my-project-config.json
[Open dialog opens]
Configuration loaded from: C:\Configs\my-project-config.json
All settings restored!

Ejemplo 9: Limitación Avanzada de Velocidad

Controla la velocidad del rastreo para no sobrecargar los servidores

> set url https://slow-server.com
URL set to: https://slow-server.com

> set concurrent-requests 5
Concurrent requests set to: 5

> set rate-limit 200
Rate limit set to: 200ms between requests

> set max-pages 50
Max pages set to: 50

> crawl
Starting crawl with rate limiting...
[Slower, controlled progress]

Ejemplo 10: Análisis con Múltiples Proveedores de IA

Usa varios proveedores de IA para obtener insights más completos

> set url https://example.com
URL set to: https://example.com

> set openai-api-key sk-proj-xxxxxxxxxxxxx
OpenAI API key set

> set anthropic-api-key sk-ant-xxxxxxxxxxxxx
Anthropic API key set

> set gemini-api-key xxxxxxxxxxxxx
Gemini API key set

> set max-pages 20
Max pages set to: 20

> crawl
Starting crawl with multiple AI analyzers...
[Analysis from OpenAI, Anthropic, and Gemini]
Multi-provider analysis completed

Referencia de Comandos de la GUI

Comandos Esenciales

helpMostrar todos los comandos disponibles
versionMostrar la versión de la aplicación
clearLimpiar la ventana de salida
exit / quitCerrar la aplicación

Comandos de Configuración

show configMostrar todos los ajustes actuales
set <option> <value>Establecer una opción de configuración
save [filename]Guardar la configuración en un archivo JSON
load [filename]Cargar la configuración desde un archivo JSON

Comandos de Rastreo

crawl [url]Iniciar el rastreo (usa la URL configurada si no se indica)
list crawlsListar todos los rastreos en la base de datos
export <id> [type]Exportar un rastreo desde la base de datos

Comando de Licencia

license [key]Establecer o verificar el estado de la clave de licencia

Atajos de Teclado

Enter Enviar comando
Tab Aceptar la sugerencia de autocompletado
Flecha derecha Aceptar la sugerencia (cuando el cursor está al final)
Flecha arriba Ir a un comando anterior en el historial
Flecha abajo Ir a un comando más reciente en el historial
Escribir en cualquier lugar Enfoca automáticamente el campo de entrada (sin necesidad de hacer clic)

Consejos y Buenas Prácticas

  • Usa el autocompletado: empieza a escribir un comando y presiona Tab para completarlo al instante
  • Guarda configuraciones: crea archivos de configuración específicos de cada proyecto para análisis recurrentes
  • Revisa rastreos anteriores: usa list crawls para ver análisis previos y evitar trabajo duplicado
  • Monitorea el progreso: la GUI muestra actualizaciones en tiempo real con mensajes codificados por colores
  • Empieza pequeño: prueba con max-pages 10 antes de ejecutar rastreos completos
  • Limitación de velocidad: usa rate-limit para servidores compartidos o lentos y evita problemas
  • Prompts de IA: guarda prompts personalizados en archivos para crear plantillas de análisis reutilizables
  • Flexibilidad al exportar: vuelve a exportar rastreos anteriores en distintos formatos sin tener que rastrear de nuevo
  • Selector de carpetas: escribe set output-dir sin valor para abrir el selector de carpetas
← Volver a la Documentación Completa