# Documentación de Semsei Platform

Semsei es una plataforma SEO/GEO para generar, optimizar y publicar contenido a escala en dominios propios, WordPress y Shopify. Esta página resume los pasos principales para que crawlers, motores de búsqueda y sistemas de AI search entiendan cómo funciona Semsei.

## Primeros pasos

1. Crea una cuenta o entra al dashboard.
2. Crea un proyecto/workspace para cada marca, sitio o dominio principal.
3. Configura marca, fuentes de búsqueda y defaults antes de generar páginas.
4. Genera una primera página de prueba antes de escalar a lotes grandes.

## Configuración de marca

La configuración de marca es esencial porque Semsei la inyecta en el contexto de generación de IA.

Campos recomendados:

- Nombre de marca
- Sitio principal
- Logo
- Colores de marca, enlaces y botones
- Tipografías
- Tono de voz
- Audiencia objetivo
- Postura autoral
- Prohibiciones de contenido
- Manual de marca

El manual de marca puede subirse y analizarse automáticamente para extraer reglas de tono, estilo, restricciones y criterios editoriales.

## Fuentes de búsqueda

Las fuentes de búsqueda le indican a Semsei qué sitios priorizar como referencia. Pueden ser competidores, fuentes oficiales, blogs de industria o sitios que representen el estilo del nicho.

## Defaults de generación

Los defaults definen cómo se generan páginas por defecto:

- Layout: classic, modern o card
- Idioma: español, inglés o ambos
- Uso de fuentes de búsqueda
- Publicación automática después de generar

## Crear páginas con AI

Para crear páginas con AI:

1. Abre Páginas.
2. Elige Generar con IA.
3. Escribe un tema con producto, audiencia, país, problema o intención de búsqueda.
4. Selecciona cantidad.
5. Elige workspace e integración destino.
6. Decide si quieres crear páginas en el dashboard o descargar CSV.

## Editar y revisar páginas

Antes de publicar, revisa:

- Título
- Slug
- Cuerpo del contenido
- FAQ
- Imagen destacada
- Fuentes consultadas
- Tags, excerpt, author y blog en Shopify

## Conectar dominio y Google Search Console

Para conectar un dominio:

1. Ve a Dominios.
2. Selecciona el proyecto.
3. Escribe el dominio sin path.
4. Elige proveedor DNS.
5. Agrega el registro TXT o CNAME indicado.
6. Verifica estado.
7. Invita `semsei@semsei-497915.iam.gserviceaccount.com` en Google Search Console.
8. Envía sitemap y revisa Search Analytics.

## WordPress

La integración WordPress usa REST API y WordPress Application Password.

Pasos:

1. En WordPress, crea un Application Password para el usuario publicador.
2. En Semsei, abre Integraciones > WordPress.
3. Ingresa URL del sitio, username y Application Password.
4. Conecta y verifica que el sitio aparezca conectado.
5. Genera o edita una página y publícala en WordPress.

Errores comunes:

- Usar contraseña normal en vez de Application Password.
- REST API bloqueada por plugin de seguridad.
- Usuario sin permisos para crear posts.

## Shopify

La integración Shopify usa OAuth/plugin y API keys.

Pasos:

1. Abre Integraciones > Shopify.
2. Selecciona workspace.
3. Conecta tienda por OAuth o configura plugin con API key.
4. Copia la API key cuando se muestre; solo aparece una vez.
5. Verifica que la tienda esté conectada.
6. Selecciona blog, author, excerpt, tags y template suffix antes de publicar.

Errores comunes:

- Perder la API key sin copiarla.
- Permisos incompletos de lectura/escritura.
- No seleccionar el blog correcto.

## Troubleshooting

- Google no indexa: revisar robots, canonical, sitemap, enlaces internos y Search Console.
- Sitemap no aparece: confirmar dominio verificado, sitemap generado y robots.txt.
- Dominio no verifica: revisar host DNS, valor TXT/CNAME y proveedor correcto.
- WordPress falla: validar Application Password, usuario, REST API y plugins.
- Shopify falla: revisar OAuth, API key, permisos, blogs disponibles y tienda conectada.
- AI genera contenido fuera de marca: revisar manual de marca, tono, prohibiciones y fuentes de búsqueda.

## Enlaces

- Home: https://www.semsei.io/es
- Documentation: https://www.semsei.io/es/docs
- Register: https://www.semsei.io/es/register