Aprende a configurar el comportamiento principal de SEO Magic: Gemini API key, site topic, language, SEO plugin integration, Autopilot, Google APIs (PRO), ACF integration (PRO) and import/export options.
Panorama general: cómo se organizan los ajustes
El Ajustes pantalla en SEO Magic se divide en varias secciones:
- Ajustes generales – comportamiento básico del plugin (libre).
- Autopilot – automatización de fondos para rellenar los metadatos y campos de medios desaparecidos (libre).
- Ajustes de Google API – configuración centralizada para servicios avanzados de Google (PRO).
- ACF Integration – elegir qué campos ACF se utilizan como contexto AI (PRO).
- Reglas modelo AI (Advanced) – reglas opcionales para utilizar diferentes modelos de IA basados en condiciones.
- Ajustes de importación / exportación – respaldo y migra tu configuración.
Este artículo explica cada sección y cómo trabajan juntos.
Ajustes generales (libre)
Google Gemini API Key
Campo: Google Gemini API Key + Test Connection
Propósito: clave principal para todas las generaciones de IA.
- SEO Magic utiliza esta llave para llamar Google Gemini modelos.
- Sin una clave válida, el plugin no puede generar metadatos, texto alt o contenido.
- Puedes conseguir una llave de Google AI Studio.
Cómo configurarlo:
- Pruebe su llave en el campo.
- Haga clic Test Connection.
- Espera el mensaje de éxito o error.
Si la prueba falla:
- Compruebe que la clave está completa (sin espacios adicionales).
- Asegúrese de que la API Gemini está habilitada para esa clave.
- Verifique que su servidor puede hacer solicitudes de HTTPS salientes (algunos cortafuegos los bloquean).

Tema principal del sitio
Campo: Main Site Topic
Una breve descripción de lo que se trata de su sitio.
Ejemplo:
“Descubre, discuta y analice las mejores películas y programas de televisión”.
Este texto es enviado a la AI como contexto mundial y ayuda al modelo:
- Comprende tu nicho y el público típico.
- Elige ángulos y palabras clave más relevantes.
- Mantenga los títulos y descripciones alineados con su tema.
Manténgalo corto, pero específico.

Modelo AI predeterminado
Campo: Default AI Model (por ejemplo. Gemini 2.0 Flash (Recomendado))
Este es el modelo SEO Magic utilizará cuando:
- No Regla modelo AI aplica al contenido actual.
- Una herramienta no solicita explícitamente un modelo diferente.
Si no estás seguro de qué elegir, Gemini 2.0 Flash es un defecto sólido (rápido y buena calidad).

Lenguaje de generación
Campo: Generation Language (por ejemplo. Español, Inglés)
Controla los idioma de salida predeterminado para las generaciones de IA:
- Títulos, descripciones, texto alt y contenido se generarán en este idioma por defecto.
- Algunas herramientas le permiten anular el lenguaje en el impulso, pero este es el escenario global.
Establezca esto al idioma principal de su sitio web.

SEO Integración Plugin
Campo: SEO Plugin Integration (por ejemplo. Todo en un solo SEO (AIOSEO), Yoast, Rank Math)
Aquí usted elige el plugin SEO Magic debe sincronización con:
- Sólo se enumeran los plugins activos de SEO.
- SEO Magic maps its internal fields (title, description, social tags) to the correct meta claves de ese plugin.
Resultado:
- Los metadatos generados por SEO Magic aparecen dentro de su plugin SEO.
- Puede seguir utilizando su interfaz de usuario plugin de SEO habitual para revisar o ajustar títulos/descripciones.

Tipos de Contenido de Escaneo
Campo: Scan Content Types
Una lista de tipos de correos donde usted decide qué contenido SEO Magic debe manejar, por ejemplo:
- Puestos
- Páginas
- Tipos de correo personalizados (por ejemplo, “Movies”, “Cortes”, “Productos”, etc.)
Sólo los tipos seleccionados:
- Se incluye en métricas de cobertura en el Dashboard.
- Aparecer en las herramientas Posts / Metadatos SEO.
- Ser escaneado por Autopilot (si está habilitado).
Si quieres que SEO Magic ignore ciertos tipos de contenido, déjalos sin revisar.

Limpieza de datos
Campo: Delete all plugin data upon deactivation
- Cuando esté habilitado, SEO Magic eliminará su configuración, registros y puntuaciones internas cuando el plugin está desactivado.
- Esto es irreversible.
Si usted sólo planea desactivar el plugin temporalmente, o desea guardar datos históricos, deje esto convertido apagado.

Autopilot (libre)
El Autopilot sección controla una tarea de fondo opcional que completa los metadatos y campos de medios desaparecidos automáticamente de acuerdo con sus reglas.
Autopilot está disponible en ambos Gratis y PRO versiones.
PRO simplemente añade más herramientas que se benefician de tener todos esos metadatos llenos.
Activar el piloto automático
Campo: Enable Autopilot
- Interruptor maestro para todas las funciones de Autopilot.
- Si esto es deshabilitado, ninguna generación de antecedentes funcionará.
Frecuencia del escáner
Campo: Scan Frequency (por ejemplo. Hora)
Define con qué frecuencia Autopilot escanea el sitio para optimizar el contenido:
- Cada hora
- Varias veces al día
- Una vez por día (dependiendo de las opciones que elija)
SEO Magic se basa en WordPress cron (wp-cron) o su cron servidor para ejecutar estos escaneos. Asegúrese de que las tareas programadas estén funcionando correctamente en su sitio.
Sobre la descarga de imágenes
Campo: On Image Upload – Generate metadata (Alt Text, Title, etc.) automatically when a new image is uploaded.
Cuando esté habilitado:
- Cada nueva imagen subida a la Biblioteca de Medios se procesa automáticamente.
- SEO Magic genera:
- Título
- Texto Alt
- Caption
- Descripción
utilizando el nombre de archivo, el tema del sitio y cualquier contexto disponible.
Campos de Contenido (Autopiloto)
Grupo de campo: Content Fields
Aquí usted decide qué post-level SEO fields Autopilot se permite llenar:
- Meta Title
- Meta Descripción
- Título de Facebook
- Facebook Descripción
- Título de Twitter
- Twitter Descripción
Sólo los campos comprobados se generan automáticamente.
Los valores existentes generalmente se preservan; Autopilot se centra en el llenado desaparecido campos.
Campos de imagen (Autopilot)
Grupo de campo: Image Fields
Aquí usted decide qué medios de comunicación Autopilot puede completar:
- Título
- Texto Alt
- Caption
- Descripción
De nuevo, sólo se llenan los campos comprobados y se respetan los valores existentes.
Cómo funciona Autopilot internamente
- En cada carrera programada, Autopilot escanea el seleccionado Tipos de contenido y encuentra artículos con desaparecido campos en los campos Contenidos / Campos de Imagen que habilitaste.
- Para cada artículo, SEO Magic prepara un aviso usando:
- El Tema principal del sitio,
- El contenido actual o información multimedia,
- El Lenguaje de generación,
- Y el Modelo AI predeterminado (o un modelo de reglas modelo AI, si está configurado).
- Envia la solicitud a Gemini y guarda los valores generados en los metadatos o campos de medios apropiados.
Puede apagar Autopilot en cualquier momento si prefiere un flujo de trabajo totalmente manual.

Configuración de Google API (PRO)
Disponible en la versión PRO. Centraliza las claves de Google API para funciones avanzadas como Auto-Linking, Backlink Audit y Site Health Audit.
Google Search API Key
Campo: Google Search API Key
Utilizado para:
- Auto-Linking Assistant (Descubre fuentes externas y posibles objetivos de enlace).
- Auditoría de Backlink (Comprobaciones de navegación).
- Auditoría de salud del sitio (PageSpeed requests).
En su proyecto Google Cloud, asegúrese de habilitar:
- API de búsqueda personalizada
- API de navegación segura
- PageSpeed Insights API

ID del motor de búsqueda programable
Campo: Programmable Search Engine ID
- Necesario para el Auto-Linking Assistant.
- SEO Magic utiliza este ID para consultar su motor de búsqueda programable (CSE) y encontrar enlaces externos relevantes.

Google OAuth Client ID & Client Secret
Campos: Google OAuth Client ID, Google OAuth Client Secret
Estos son necesarios para el Auditoría de backlink:
- Permiten que SEO Magic se conecte a su Google Search Console cuenta vía OAuth.
- El plugin recupera datos de backlink de Search Console para agruparlo y analizarlo.
Usted debe añadir un redirección URI como este en sus credenciales de Google Cloud OAuth:
https://your-site.com/wp-admin/admin.php?page=smg-backlink-audit
(Sustitución your-site.com con su dominio real.)
Si la redirección URI está desaparecida o incorrecta, el flujo OAuth fallará.

ACF Integration (PRO)
El ACF Integration sección permite a los usuarios de PRO elegir cuál Campos personalizados avanzados debe ser leído por la AI como contexto extra.
Casos de uso típico:
- Para un tipo de correo personalizado “Person”: campos como “Nombre completo”, “Biografía corta”, “Regla de perfil social”.
- Para un tipo “Movie” o “Producto”: campos como “Año de liberación”, “Brand”, “Platform”, “Rating”, etc.
Principales detalles:
- Sólo simple basado en texto Los campos de ACF se enumeran (página texto, textarea, URL…).
- Esto mantiene la luz de los impulsos y evita el envío de estructuras de datos complejas.
Cuando selecciona campos para un tipo de correo:
- SEO Magic incluye esos valores en el contexto al generar contenido, metadatos y texto alt.
- La AI obtiene una comprensión más profunda y estructurada de cada elemento.

Reglas modelo AI (Advanced)
El Normas modelo AI panel le permite definir reglas condicionales, por ejemplo:
“Si el tipo de publicación es ‘Producto’, utilice el modelo A; si la categoría es ‘Noticias’, utilice el modelo B.”
- Se evalúan las normas en orden.
- La primera regla coincidente se utiliza.
- Si ninguna regla coincide, SEO Magic vuelve a la Modelo AI predeterminado.
Puede dejar esto vacío (sin reglas) para mantener la configuración sencilla, o añadir reglas más tarde si necesita un control más fino.

Ajustes de importación / exportación
Esta sección está disponible tanto en Free como en PRO.
Exportar – Descargar archivos Ajustes
- Haga clic Descargar Configuración Archivo para exportar su configuración actual como
.jsonarchivo. - Este archivo incluye tu configuración SEO Magic (no tu contenido).
Útil para:
- Tomar un respaldo antes de grandes cambios.
- Reutilizando la misma configuración en múltiples sitios.
Importar – Aplicar una configuración guardada
- Usar el Importación botón para subir
.jsonarchivo previamente exportado de SEO Magic. - Cuando haga clic Ajustes de importación, su configuración actual será sobrescrito.
Siempre revise la pantalla Ajustes después de una importación, especialmente si el archivo vino de un sitio diferente (puede contener claves de API o URL específicas para ese entorno).
