GMC SEO API — Documentación (WordPress)
GMC SEO API es una capa SEO automática y gratuita para WordPress. Una vez activado, genera las etiquetas SEO técnicas que necesita cada página — títulos basados en plantillas, meta descripciones, URLs canónicas, directivas robots, etiquetas Open Graph y Twitter Card, un grafo de schema JSON-LD, texto alt automático para imágenes y hreflang — sin editar ninguna plantilla. Además, expone una API protegida por clave que permite a un sistema externo leer y escribir valores SEO para cualquier URL, de modo que una herramienta SEO centralizada puede enviar títulos y descripciones al sitio sin iniciar sesión en wp-admin. Funciona tanto como motor SEO completo e independiente como, en sitios que ya usan Yoast SEO o Rank Math, como canal puro de override: cuando cualquiera de esos plugins está activo, GMC SEO API le cede el paso y deja de emitir sus propias etiquetas para que nada se duplique.
Requisitos: WordPress 6.0 o superior, PHP 8.1 o superior. El plugin se entrega en inglés, italiano y español y respeta la configuración multilingüe de tu sitio.
Instalación
- Descarga el
.zipdel plugin desde tu cuenta. No lo descomprimas. - En tu escritorio de WordPress ve a Plugins → Añadir nuevo → Subir plugin.
- Elige el archivo
.zip, haz clic en Instalar ahora y luego en Activar. - Tras la activación, la pantalla de ajustes del plugin aparece en el menú de administración.
Configuración
Abre la pantalla de ajustes del plugin en el menú de administración. En una instalación nueva importan dos cosas:
- Salida automática de etiquetas. De serie, el plugin genera títulos, meta descripciones, canónicas, directivas robots, etiquetas Open Graph / Twitter Card, el grafo de schema JSON-LD, el autocompletado del alt de las imágenes y hreflang para cada página. No hace falta ningún trabajo por página — las etiquetas se producen automáticamente a medida que se publica el contenido.
- Clave de API. La API de override por URL está protegida por una clave que configuras en la pantalla de ajustes. Establece esta clave antes de usar la API; cualquier consola o script externo que llame al endpoint debe presentarla. Mantén la clave en privado — trátala como una contraseña.
Si Yoast SEO o Rank Math está instalado y activo, no se necesita configuración adicional para la coexistencia: el plugin los detecta y se retira automáticamente de la emisión de etiquetas, mientras la API de override sigue disponible.
Uso del plugin
Capa SEO automática
Usado por sí solo, el plugin dota al sitio de una capa SEO técnica completa. Publica el contenido con normalidad; el plugin rellena títulos basados en plantillas, meta descripciones, URLs canónicas, directivas robots, etiquetas de vista previa social, datos estructurados, atributos alt de imágenes y hreflang para páginas multilingües. No hay nada que activar manualmente.
API de override por URL
La API de override permite leer y escribir valores SEO para una URL concreta desde fuera de WordPress — por ejemplo, desde una consola SEO externa. En lugar de iniciar sesión en el admin de cada sitio, el sistema externo envía títulos, descripciones y otros valores SEO a la URL de destino a través del endpoint protegido por clave. La API permanece activa en todos los modos, incluso cuando Yoast o Rank Math gestiona la salida de etiquetas.
Funcionamiento junto a Yoast o Rank Math
Si cualquiera de los dos plugins está activo, GMC SEO API le cede el paso, de modo que las etiquetas nunca se emiten dos veces. En este modo el producto actúa exclusivamente como canal de override programático — conservas tu stack SEO actual y ganas control remoto por URL. No necesitas eliminar ni reconfigurar el otro plugin.
Comprobar que funciona
- Abre un artículo en el frontend y visualiza el código fuente de la página.
- Confirma que las etiquetas de título, canónica y Open Graph aparecen exactamente una vez en el
<head>. - Envía un override por URL a través de la API (o de la pantalla del plugin) y recarga la página para confirmar que se sirven los nuevos valores.
Actualizaciones y licencia
GMC SEO API es gratuito, por lo que no se requiere ninguna Download Key — las actualizaciones llegan automáticamente. El plugin consulta por sí solo el servidor de actualizaciones de GMC / FuerteventuraTV (aproximadamente cada 12 horas) y las nuevas versiones aparecen en Plugins y en Escritorio → Actualizaciones como cualquier otro plugin; actualiza con un clic. También puedes volver a descargar la última versión desde tu cuenta en cualquier momento.
El software se publica bajo la GNU GPL. La licencia cubre únicamente el plugin de WordPress gmc-seo-api; el paquete SEO para Joomla (GMC SEO) es un producto independiente para sitios Joomla.
Soporte
Para obtener ayuda, escríbenos por WhatsApp al +34 633 168 995 o responde al correo que recibiste con el plugin. Incluye el nombre y la versión del producto (p. ej. GMC SEO API 1.5.5), tus versiones de WordPress y PHP, y una URL pública o una captura de pantalla del problema — con cualquier clave de API oculta. Respondemos en inglés, italiano y español.
Todo incluido
53 funcionalidades reales, agrupadas por área — toda la capa de SEO técnico para Joomla y WordPress, sin reservarnos nada.
SEO on-page automático
- Plantillas para el título del documento — construye cada título de página a partir de un patrón %title% %sep% %sitename% con un separador configurable, de modo que los títulos se mantienen coherentes en todo el sitio sin editar plantillas.
- Meta description automática — rellena una meta description ausente a partir del extracto/contenido del artículo con truncado por palabra completa, de modo que las páginas nunca salen con la description en blanco.
- Canonical autorreferencial — inyecta una URL canonical donde la página no tiene ninguna, y omite las páginas que ya declaran una (y las URL index.php no SEF), evitando señales de contenido duplicado.
- Control del meta robots — define las directivas index/follow por URL desde una allowlist de tokens validados (noindex, nofollow, etc.), respetando la visibilidad ya establecida en el CMS.
- Protecciones contra etiquetas duplicadas — cada emisor comprueba si ya existe una etiqueta antes de escribir, de modo que nada se emite dos veces.
SEO de páginas de etiqueta (Joomla)
- Títulos y descriptions únicos por etiqueta — asigna a cada página de etiqueta de com_tags un título y una meta description distintos (mediante una variable de plantilla {tag}) en lugar de textos casi idénticos, respetando tu ajuste de título-de-página/nombre-del-sitio.
- Reserva de plantilla de description — un patrón de description predeterminado rellena las páginas de etiqueta que no tienen texto personalizado.
- Noindex en etiquetas vacías — establece opcionalmente noindex en las páginas de etiqueta con cero elementos, manteniendo las páginas pobres fuera del índice.
Compartición social (Open Graph y Twitter)
- Etiquetas Open Graph automáticas — emite og:title, og:description, og:image y og:type para que los enlaces se previsualicen correctamente en Facebook, LinkedIn y las apps de mensajería (opt-in).
- Etiquetas Twitter Card — genera tarjetas summary_large_image para previsualizaciones enriquecidas en Twitter/X (opt-in).
- Overrides sociales por URL — define un og:title, og:description y og:image personalizados para cualquier URL concreta.
- Imagen de compartición predeterminada — se usa una imagen de reserva para todo el sitio en og:image/twitter:image cuando una página no tiene imagen destacada ni en línea.
Datos estructurados (esquema JSON-LD)
- Grafo de identidad del sitio — emite un grafo JSON-LD WebSite / Organization-o-Person / WebPage (+ BreadcrumbList) para que los buscadores comprendan la identidad de tu sitio.
- Esquema Article / BlogPosting — añade datos estructurados BlogPosting a los artículos de contenido con publisher, logo y sameAs, mejorando la elegibilidad para rich results.
- Elección Organization / Person — declara el sitio como Organization o como Person, con nombre, URL del logo y enlaces a perfiles sociales (sameAs).
- Consolidación del esquema — deduplica los bloques de identidad Organization/WebSite en conflicto (procedentes de plantillas u otras extensiones) en un único grafo limpio.
- Corrección del esquema de la página de inicio — elimina un nodo Article espurio en la portada que algunas configuraciones emiten, manteniendo correcto el esquema de la homepage.
- Salida segura — el JSON-LD se emite con endurecimiento JSON_HEX_TAG e inserción segura frente a backreferences.
Motor de texto alternativo de imágenes
- Relleno automático del alt ausente — inyecta alt en las etiquetas <img> que carecen de él (contenido, miniaturas, widgets y bloques de imagen de Gutenberg en WP), mejorando la accesibilidad y el SEO de imágenes.
- Mapa central de alt text — guarda un valor alt por origen de imagen una sola vez y hazlo aplicar en todos los lugares donde aparece esa imagen (emparejado por origen normalizado + hash).
- Reserva por nombre de archivo — deriva opcionalmente un alt text legible del nombre del archivo de imagen cuando no existe un alt guardado.
- Reserva por palabras clave — deriva opcionalmente el alt de las palabras clave de la página (Joomla).
- Interruptor para omitir los existentes — deja intactas las imágenes que ya tienen alt text.
- Editor masivo de alt — pantalla de administración en línea para editar muchos valores alt a la vez (guardar-todo / añadir / eliminar) con un filtro de "solo alt vacío".
- Compatible con lazy-load — gestiona tanto src como data-src (funciona con YOOtheme/lazyload) y usa el emparejamiento por límite de palabra para que data-alt/data-src nunca se interpreten mal.
Multilingüe / hreflang
- Mapa hreflang estático — declara clústeres rel=alternate hreflang por ruta (path | lang=URL | x-default=URL), incluidas URL entre dominios, con comentarios #.
- Respeta las asociaciones existentes — omite los idiomas ya declarados por las asociaciones de idioma de Joomla (o Polylang/WPML/Yoast en WP) para evitar etiquetas hreflang en conflicto.
Overrides por URL y edición masiva
- Overrides SEO por URL — sobrescribe título, meta description, robots, canonical y etiquetas sociales para cualquier URL exacta, desde un formulario de administración.
- Gestión de la lista de overrides — explora, edita, publica/despublica y elimina los overrides guardados.
- Exportación CSV — descarga todos los overrides como CSV UTF-8 (listo para Excel) para copia de seguridad o edición masiva.
- Importación CSV (upsert) — reimporta el CSV para crear/actualizar overrides en bloque, emparejados por URL, con un informe de creados/actualizados/omitidos.
Auditoría SEO y panel de control
- Panel — estado de un vistazo: plugin activo, número de overrides, número de etiquetas y avisos de etiquetas vacías, además del panel de la API JSON.
- Vista de auditoría SEO — cuenta los artículos publicados que carecen de meta description y las filas de imagen con alt vacío, con saltos de un clic para corregir cada elemento.
- Fichas de salud del sitio — totales de artículos publicados y de overrides mostrados como tarjetas de resumen.
- Generar la clave API con un clic — crea/rota la clave de la consola desde el panel (protegida con CSRF, criptográficamente aleatoria).
Verificación de buscadores
- Meta de verificación — pega los tokens de contenido de Google Search Console, Bing Webmaster y Yandex Webmaster para emitir las etiquetas <meta> de verificación sin editar la plantilla (vacío = no se emite nada).
API de consola central (desarrolladores / integraciones)
- API JSON protegida por clave — lee y escribe overrides por URL desde fuera del CMS, para que una consola externa pueda gestionar el SEO en muchos sitios con un único esquema de autenticación.
- Autenticación solo por cabecera — la clave viaja únicamente en la cabecera X-Gmcseo-Key (comparada con hash_equals); nunca se acepta como parámetro de consulta, y una clave vacía/desactivada devuelve 403/404.
- Endpoints de overrides — list, get, save (upsert al estilo PATCH: solo cambian los campos enviados, borrado por valor vacío) y delete.
- Endpoints de alt de imagen — alt_list, alt_get, alt_save, alt_delete para gestionar el texto alternativo mediante la API (Joomla; WP expone una ruta REST /gmcseo/v1/alt).
- Envoltorio paginado y validado — { ok, count, limit, offset, items } con un recuento total de coincidencias, limit acotado a 1..1000, longitudes máximas por campo, allowlist de robots y validación de URL canonical/og solo http(s).
Compatibilidad y coexistencia
- Cesión a Yoast / Rank Math (WP) — cuando Yoast o Rank Math está activo, el motor se aparta automáticamente en título/meta/OG/esquema para evitar etiquetas duplicadas, mientras el relleno de alt y el mapa hreflang estático siguen funcionando.
- Interruptores por funcionalidad — cada emisor (título, meta, canonical, robots, OG, Twitter, esquema, alt, hreflang) puede activarse/desactivarse de forma independiente.
- Precedencia de los overrides — un override por URL siempre gana sobre la salida automática del motor.
- Ligero — una capa de SEO técnico específica en lugar de una pesada suite todo-en-uno; funciona en Joomla 5.x/6.x y WordPress 5.6+ (PHP 8.1+).
Confianza y licencia
- Con licencia GPLv2 — LICENSE.txt GPLv2 completo incluido en el paquete y en el plugin; conforme con JED.
- Autoalojado, sin servicio externo — toda la salida SEO y la API de consola se ejecutan en tu propio sitio; no se envía ningún dato a una nube SEO de terceros.
- Actualizaciones incluidas — actualizaciones de un clic mediante el servidor de actualizaciones integrado (Joomla) / Update URI (WP); la auto-actualización de WordPress puede activarse o desactivarse.
- Clave de licencia por correo — los planes de pago se desbloquean con una clave enviada por correo; la versión gratuita se actualiza sin clave.
- Desinstalación limpia — la opción "eliminar todos los datos al desinstalar" (Joomla) elimina las tablas/opciones del plugin; el gemelo WP limpia en cada sitio de una red multisitio.
- Interfaz localizada — traducciones de administración en inglés, italiano y español incluidas en ambas plataformas.
Joomla y WordPress
- Joomla (pkg_gmcseo) — componente de panel de control (com_gmcseo) con vistas Panel / Overrides / Imágenes / Auditoría, plugin motor (System - GMC SEO), ACL completo + CSRF en cada acción de administración, Download Key (dlid) en el manifiesto, y el motor JSON-LD/etiquetas/hreflang. El SEO de páginas de etiqueta y la reserva de alt basada en palabras clave son específicos de Joomla.
- WordPress (gmc-seo-api) — motor independiente "equivalente a Yoast" con una pantalla de Ajustes, casillas por funcionalidad, campos de identidad del sitio, lista de overrides (lectura + eliminación), importación/exportación CSV, una ruta REST de alt text, y cesión automática a Yoast/Rank Math. hreflang se detecta automáticamente desde Polylang/WPML. Los hooks de alt específicos de WP cubren las miniaturas de las entradas, el contenido en bloques y los bloques renderizados.
