SEOPress & WP-CLI

Gestione SEOPress desde la línea de comandos con WP-CLI. Ejecute las órdenes en la instalación correcta de WordPress o use la opción --path de WP-CLI. Haga una copia de la base de datos antes de importar, eliminar o migrar. Sustituya los ID y rutas de ejemplo por sus valores.

Los comandos propios de ajustes, IA, análisis de contenido, licencia y redirecciones requieren SEOPress PRO y SEOPress Free. WordPress WP-CLI proporciona wp post meta, wp term meta y wp option. Los comandos de Insights requieren SEOPress Insights.

Exportar ajustes a un archivo JSON privado

wp seopress settings export --destination='/home/example/private/seopress-settings.json' --exclude=license,api_keys

Cree primero el directorio privado y permita la escritura al usuario de la orden. --destination admite un archivo JSON o un directorio. Un directorio usa el nombre seopress-settings.json. Sin esta opción se usa el directorio de trabajo actual. Se rechazan destinos públicos, incluidos la raíz web y uploads, y destinos que sean enlaces simbólicos. Un archivo existente en la misma ruta se sobrescribe.

Sin exclusiones, la exportación puede incluir la licencia y las credenciales API. Use --exclude=license,api_keys para una configuración reutilizable sin esas categorías. Otras categorías incluyen knowledge_graph, social_profiles, analytics_ids y verification_codes. Ejecutar wp seopress settings export --exclude muestra las categorías disponibles como error de validación y no exporta un archivo. Las extensiones pueden añadir categorías.

Importar ajustes globales

wp seopress settings import --from='/home/example/private/seopress-settings.json'

--from admite un archivo JSON o un directorio que contenga seopress-settings.json. Sin esta opción, busca en el directorio actual y luego en uploads por compatibilidad con exportaciones antiguas. Prefiera una ruta privada explícita. La importación aplica ajustes globales; revise después la configuración de destino. No sustituye una copia completa de la base de datos ni de los metadatos del contenido.

Leer, actualizar y eliminar metadatos SEO

Estos ejemplos leen el título de un contenido, lo sustituyen y eliminan el valor personalizado. La eliminación permite que se apliquen los valores predeterminados de SEOPress. Ejecute solo la operación necesaria.

wp post meta get 123 _seopress_titles_title
wp post meta update 123 _seopress_titles_title "Example SEO title"
wp post meta delete 123 _seopress_titles_title

Para términos de taxonomía, use el ID del término y la misma clave de metadatos:

wp term meta get 45 _seopress_titles_title
wp term meta update 45 _seopress_titles_title "Example category title"
wp term meta delete 45 _seopress_titles_title

Generar títulos, descripciones y textos alternativos

Configure un proveedor de IA en SEOPress PRO antes de generar. Los comandos de metadatos usan ID de contenidos; los de textos alternativos usan ID de adjuntos. Se muestran resultados para cada ID. La generación puede consumir créditos y se guarda de forma predeterminada.

wp seopress ai metadata --id=123,124 --meta=desc --language=en_US
wp seopress ai alt_text --id=456,457 --language=en_US

Para metadatos, --meta=title genera el título y --meta=desc la descripción; omita --meta para generar ambos. --language usa en_US por defecto; puede usar fr_FR o es_ES. Para metadatos, omita --autosave para mantener el guardado predeterminado; --autosave=0 genera sin guardar. Considere alt_text un comando de escritura: su argumento --autosave no ofrece una vista previa fiable sin guardar. También puede generar y guardar la leyenda y descripción del adjunto. Por defecto puede reemplazar valores existentes. Use --update_empty_alt_text=0 para limitar los cambios a campos vacíos. Pruebe con un adjunto respaldado antes de procesar una lista.

wp seopress ai metadata --id=123 --meta=title --autosave=0
wp seopress ai alt_text --id=456 --update_empty_alt_text=0

Leer y modificar opciones globales

wp option get seopress_titles_option_name --format=json
wp option patch update seopress_titles_option_name seopress_titles_home_site_title "Example homepage title"

La primera orden lee la opción; la segunda cambia solo el campo anidado del título de inicio. Para eliminar toda la opción de Títulos y metas, utilice deliberadamente la siguiente orden después de una copia de seguridad. Elimina toda la opción, no solo el título de inicio.

wp option delete seopress_titles_option_name

Gestionar la licencia PRO

Importar redirecciones por lotes

Coloque la exportación en una ubicación legible del servidor. Liste los formatos compatibles con la versión instalada y haga una simulación antes de importar. La simulación prepara y comprueba el archivo sin crear redirecciones.

wp seopress-pro redirections sources
wp seopress-pro redirections import '/home/example/private/redirects.csv' --dry-run
wp seopress-pro redirections import '/home/example/private/redirects.csv' --batch=1000
wp seopress-pro redirections import '/home/example/private/rankmath.json' --source=rankmath

--source admite csv, redirections_plugin, yoast, rankmath, rankmath_csv, slimseo, aioseo y smartcrawl. Un CSV sin origen explícito se trata como CSV de SEOPress. Un JSON requiere su origen, porque la extensión no permite identificar al exportador.

--separator admite auto (predeterminado), comma, semicolon, tab o pipe. --batch controla el número de redirecciones escritas por lote. Si se interrumpe una importación, reanude el trabajo guardado sin iniciar otro archivo:

wp seopress-pro redirections import --resume

Actualizar el análisis de contenido en segundo plano

wp seopress content-analysis run
wp seopress content-analysis status
wp seopress content-analysis cancel

Active primero la auditoría del sitio. Run pone lotes en cola y termina antes de completarlos. Debe funcionar WP-Cron o un planificador del sistema que ejecute los eventos pendientes de WordPress. Se aplican el tamaño de lote y las exclusiones configurados. Consulte status para ver el progreso y el último error. Cancel detiene la cola compartida de auditoría y conserva las puntuaciones guardadas.

Sin --post_type se conserva el alcance existente. Esta opción cambia el ajuste guardado de tipos de contenido de la auditoría; no es una sustitución temporal. Use tipos públicos registrados compatibles. Solo puede ejecutarse una auditoría a la vez.

wp seopress content-analysis run --post_type=post,page

Migrar datos de SEOPress Insights

Con SEOPress Insights 3.0, la migración traslada el historial de posiciones y backlinks desde metadatos a tablas dedicadas. Estos comandos pertenecen a Insights, no a Free ni PRO. Sin --full, cada comando procesa un lote.

wp seopress-insights migrate-backlinks
wp seopress-insights migrate-backlinks --full
wp seopress-insights migrate-rankings
wp seopress-insights migrate-rankings --full

Para posiciones, --force reinicia el desplazamiento y el estado guardados y vuelve a comenzar. Úselo solo para descartar el estado guardado de la migración, después de una copia de seguridad.

wp seopress-insights migrate-rankings --full --force

Solucionar problemas de los comandos

Si un comando propio es desconocido, compruebe el sitio, la carga de los plugins necesarios y la ayuda de la versión instalada con wp help seopress o wp help seopress-pro. Una exportación necesita acceso directo de WordPress al sistema de archivos y un destino privado escribible. Una auditoría en cola sin progreso requiere revisar los eventos programados y el error de status. Para comandos nativos, consulte la referencia de WP-CLI.

Consulte la referencia de metadatos de SEOPress para otras claves de contenidos y términos.