---
title: "Documentación GUI - bseoa | Ejemplos Paso a Paso"
description: "Documentación completa de la GUI de bseoa. Aprende a usar las aplicaciones de escritorio para Windows y macOS con ejemplos reales, flujos de trabajo y funciones avanzadas."
image: "https://www.blackseoanalyzer.com/static/images/black-seo-analyzer-og-image.png"
canonical: "https://www.blackseoanalyzer.com/es/gui-documentation"
language: "es"
---

# 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

| help | Mostrar todos los comandos disponibles |
| --- | --- |
| version | Mostrar la versión de la aplicación |
| clear | Limpiar la ventana de salida |
| exit / quit | Cerrar la aplicación |

### Comandos de Configuración

| show config | Mostrar 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 crawls | Listar 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](https://www.blackseoanalyzer.com/es/cli-documentation)

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.blackseoanalyzer.com/#organization","name":"Fiscus Technology, LLC","url":"https://www.blackseoanalyzer.com/","logo":"https://www.blackseoanalyzer.com/static/images/black-seo-analyzer.png","sameAs":["https://github.com/sethblack/black-seo-analyzer","https://www.youtube.com/@SethBlack","https://linkedin.com/in/seth-black-tx"],"founder":{"@type":"Person","@id":"https://www.blackseoanalyzer.com/#seth","name":"Seth Black","url":"https://www.blackseoanalyzer.com/about"}},{"@type":"WebSite","@id":"https://www.blackseoanalyzer.com/#website","name":"bseoa","url":"https://www.blackseoanalyzer.com/","publisher":{"@id":"https://www.blackseoanalyzer.com/#organization"}},{"@type":"WebPage","@id":"https://www.blackseoanalyzer.com/es/gui-documentation","url":"https://www.blackseoanalyzer.com/es/gui-documentation","name":"Documentación GUI - bseoa | Ejemplos Paso a Paso","description":"Documentación completa de la GUI de bseoa. Aprende a usar las aplicaciones de escritorio para Windows y macOS con ejemplos reales, flujos de trabajo y funciones avanzadas.","inLanguage":"es","isPartOf":{"@id":"https://www.blackseoanalyzer.com/#website"}},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Inicio","item":"https://www.blackseoanalyzer.com/es/"},{"@type":"ListItem","position":2,"name":"Documentación GUI","item":"https://www.blackseoanalyzer.com/es/gui-documentation"}]}]}
```
