{"id":18675,"date":"2023-06-23T15:45:23","date_gmt":"2023-06-23T13:45:23","guid":{"rendered":"https:\/\/www.seopress.org\/es\/?post_type=documentation&p=18675"},"modified":"2026-09-29T14:58:12","modified_gmt":"2026-09-29T12:58:12","slug":"seopress-wp-cli","status":"publish","type":"documentation","link":"https:\/\/www.seopress.org\/es\/soporte\/guias\/seopress-wp-cli\/","title":{"rendered":"SEOPress & WP-CLI"},"content":{"rendered":"

Gestione SEOPress desde la l\u00ednea de comandos con WP-CLI. Ejecute las \u00f3rdenes en la instalaci\u00f3n correcta de WordPress o use la opci\u00f3n --path<\/code> 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.<\/p>\n

Los comandos propios de ajustes, IA, an\u00e1lisis de contenido, licencia y redirecciones requieren SEOPress PRO y SEOPress Free. WordPress WP-CLI proporciona wp post meta<\/code>, wp term meta<\/code> y wp option<\/code>. Los comandos de Insights requieren SEOPress Insights.<\/p>\n

Exportar ajustes a un archivo JSON privado<\/h2>\n
wp seopress settings export --destination='\/home\/example\/private\/seopress-settings.json' --exclude=license,api_keys<\/code><\/pre>\n
Cree primero el directorio privado y permita la escritura al usuario de la orden. --destination<\/code> admite un archivo JSON o un directorio. Un directorio usa el nombre seopress-settings.json<\/code>. Sin esta opci\u00f3n se usa el directorio de trabajo actual. Se rechazan destinos p\u00fablicos, incluidos la ra\u00edz web y uploads, y destinos que sean enlaces simb\u00f3licos. Un archivo existente en la misma ruta se sobrescribe.<\/p>\n
Sin exclusiones, la exportaci\u00f3n puede incluir la licencia y las credenciales API. Use --exclude=license,api_keys<\/code> para una configuraci\u00f3n reutilizable sin esas categor\u00edas. Otras categor\u00edas incluyen knowledge_graph<\/code>, social_profiles<\/code>, analytics_ids<\/code> y verification_codes<\/code>. Ejecutar wp seopress settings export --exclude<\/code> muestra las categor\u00edas disponibles como error de validaci\u00f3n y no exporta un archivo. Las extensiones pueden a\u00f1adir categor\u00edas.<\/p>\n
Importar ajustes globales<\/h2>\n
wp seopress settings import --from='\/home\/example\/private\/seopress-settings.json'<\/code><\/pre>\n
--from<\/code> admite un archivo JSON o un directorio que contenga seopress-settings.json<\/code>. Sin esta opci\u00f3n, busca en el directorio actual y luego en uploads por compatibilidad con exportaciones antiguas. Prefiera una ruta privada expl\u00edcita. La importaci\u00f3n aplica ajustes globales; revise despu\u00e9s la configuraci\u00f3n de destino. No sustituye una copia completa de la base de datos ni de los metadatos del contenido.<\/p>\n
Leer, actualizar y eliminar metadatos SEO<\/h2>\n
Estos ejemplos leen el t\u00edtulo de un contenido, lo sustituyen y eliminan el valor personalizado. La eliminaci\u00f3n permite que se apliquen los valores predeterminados de SEOPress. Ejecute solo la operaci\u00f3n necesaria.<\/p>\n
wp post meta get 123 _seopress_titles_title\r\nwp post meta update 123 _seopress_titles_title \"Example SEO title\"\r\nwp post meta delete 123 _seopress_titles_title<\/code><\/pre>\n
Para t\u00e9rminos de taxonom\u00eda, use el ID del t\u00e9rmino y la misma clave de metadatos:<\/p>\n
wp term meta get 45 _seopress_titles_title\r\nwp term meta update 45 _seopress_titles_title \"Example category title\"\r\nwp term meta delete 45 _seopress_titles_title<\/code><\/pre>\n
Generar t\u00edtulos, descripciones y textos alternativos<\/h2>\n
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\u00f3n puede consumir cr\u00e9ditos y se guarda de forma predeterminada.<\/p>\n
wp seopress ai metadata --id=123,124 --meta=desc --language=en_US\r\nwp seopress ai alt_text --id=456,457 --language=en_US<\/code><\/pre>\n
Para metadatos, --meta=title<\/code> genera el t\u00edtulo y --meta=desc<\/code> la descripci\u00f3n; omita --meta<\/code> para generar ambos. --language<\/code> usa en_US<\/code> por defecto; puede usar fr_FR<\/code> o es_ES<\/code>. Para metadatos, omita --autosave<\/code> para mantener el guardado predeterminado; --autosave=0<\/code> genera sin guardar. Considere alt_text<\/code> un comando de escritura: su argumento --autosave<\/code> no ofrece una vista previa fiable sin guardar. Tambi\u00e9n puede generar y guardar la leyenda y descripci\u00f3n del adjunto. Por defecto puede reemplazar valores existentes. Use --update_empty_alt_text=0<\/code> para limitar los cambios a campos vac\u00edos. Pruebe con un adjunto respaldado antes de procesar una lista.<\/p>\n
wp seopress ai metadata --id=123 --meta=title --autosave=0\r\nwp seopress ai alt_text --id=456 --update_empty_alt_text=0<\/code><\/pre>\n
Leer y modificar opciones globales<\/h2>\n
wp option get seopress_titles_option_name --format=json\r\nwp option patch update seopress_titles_option_name seopress_titles_home_site_title \"Example homepage title\"<\/code><\/pre>\n
La primera orden lee la opci\u00f3n; la segunda cambia solo el campo anidado del t\u00edtulo de inicio. Para eliminar toda la opci\u00f3n de T\u00edtulos y metas, utilice deliberadamente la siguiente orden despu\u00e9s de una copia de seguridad. Elimina toda la opci\u00f3n, no solo el t\u00edtulo de inicio.<\/p>\n
wp option delete seopress_titles_option_name<\/code><\/pre>\n
Gestionar la licencia PRO<\/h2>\n\n\n\n\n\n\n\n\n\n
Comando<\/th>\nEfecto<\/th>\n<\/tr>\n<\/thead>\n
wp seopress-pro license activate<\/code><\/td>\nActiva la clave guardada; --key<\/code> permite proporcionar una. Una constante SEOPRESS_LICENSE_KEY<\/code> definida tiene prioridad.<\/td>\n<\/tr>\n
wp seopress-pro license deactivate<\/code><\/td>\nDesactiva la licencia del sitio actual.<\/td>\n<\/tr>\n
wp seopress-pro license status<\/code><\/td>\nMuestra el estado guardado, la caducidad y la informaci\u00f3n enmascarada de la clave.<\/td>\n<\/tr>\n
wp seopress-pro license reset<\/code><\/td>\nBorra ajustes de licencia guardados y cach\u00e9s de actualizaci\u00f3n; no elimina una constante de wp-config.php.<\/td>\n<\/tr>\n
wp seopress-pro license update<\/code><\/td>\nComprueba e instala una actualizaci\u00f3n PRO disponible; se necesita una licencia v\u00e1lida para obtener actualizaciones con licencia.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Importar redirecciones por lotes<\/h2>\n
Coloque la exportaci\u00f3n en una ubicaci\u00f3n legible del servidor. Liste los formatos compatibles con la versi\u00f3n instalada y haga una simulaci\u00f3n antes de importar. La simulaci\u00f3n prepara y comprueba el archivo sin crear redirecciones.<\/p>\n
wp seopress-pro redirections sources\r\nwp seopress-pro redirections import '\/home\/example\/private\/redirects.csv' --dry-run\r\nwp seopress-pro redirections import '\/home\/example\/private\/redirects.csv' --batch=1000\r\nwp seopress-pro redirections import '\/home\/example\/private\/rankmath.json' --source=rankmath<\/code><\/pre>\n
--source<\/code> admite csv<\/code>, redirections_plugin<\/code>, yoast<\/code>, rankmath<\/code>, rankmath_csv<\/code>, slimseo<\/code>, aioseo<\/code> y smartcrawl<\/code>. Un CSV sin origen expl\u00edcito se trata como CSV de SEOPress. Un JSON requiere su origen, porque la extensi\u00f3n no permite identificar al exportador.<\/p>\n
--separator<\/code> admite auto<\/code> (predeterminado), comma<\/code>, semicolon<\/code>, tab<\/code> o pipe<\/code>. --batch<\/code> controla el n\u00famero de redirecciones escritas por lote. Si se interrumpe una importaci\u00f3n, reanude el trabajo guardado sin iniciar otro archivo:<\/p>\n
wp seopress-pro redirections import --resume<\/code><\/pre>\n
Actualizar el an\u00e1lisis de contenido en segundo plano<\/h2>\n
wp seopress content-analysis run\r\nwp seopress content-analysis status\r\nwp seopress content-analysis cancel<\/code><\/pre>\n
Active primero la auditor\u00eda 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\u00f1o de lote y las exclusiones configurados. Consulte status para ver el progreso y el \u00faltimo error. Cancel detiene la cola compartida de auditor\u00eda y conserva las puntuaciones guardadas.<\/p>\n
Sin --post_type<\/code> se conserva el alcance existente. Esta opci\u00f3n cambia el ajuste guardado de tipos de contenido de la auditor\u00eda; no es una sustituci\u00f3n temporal. Use tipos p\u00fablicos registrados compatibles. Solo puede ejecutarse una auditor\u00eda a la vez.<\/p>\n
wp seopress content-analysis run --post_type=post,page<\/code><\/pre>\n
Migrar datos de SEOPress Insights<\/h2>\n
Con SEOPress Insights 3.0, la migraci\u00f3n traslada el historial de posiciones y backlinks desde metadatos a tablas dedicadas. Estos comandos pertenecen a Insights, no a Free ni PRO. Sin --full<\/code>, cada comando procesa un lote.<\/p>\n
wp seopress-insights migrate-backlinks\r\nwp seopress-insights migrate-backlinks --full\r\nwp seopress-insights migrate-rankings\r\nwp seopress-insights migrate-rankings --full<\/code><\/pre>\n
Para posiciones, --force<\/code> reinicia el desplazamiento y el estado guardados y vuelve a comenzar. \u00daselo solo para descartar el estado guardado de la migraci\u00f3n, despu\u00e9s de una copia de seguridad.<\/p>\n
wp seopress-insights migrate-rankings --full --force<\/code><\/pre>\n
Solucionar problemas de los comandos<\/h2>\n
Si un comando propio es desconocido, compruebe el sitio, la carga de los plugins necesarios y la ayuda de la versi\u00f3n instalada con wp help seopress<\/code> o wp help seopress-pro<\/code>. Una exportaci\u00f3n necesita acceso directo de WordPress al sistema de archivos y un destino privado escribible. Una auditor\u00eda en cola sin progreso requiere revisar los eventos programados y el error de status. Para comandos nativos, consulte la referencia de WP-CLI<\/a>.<\/p>\n
Consulte la referencia de metadatos de SEOPress<\/a> para otras claves de contenidos y t\u00e9rminos.<\/p>\n","protected":false},"featured_media":0,"parent":0,"template":"","meta":{"_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","_seopress_robots_follow":"","_seopress_robots_imageindex":"","_seopress_robots_snippet":"","_seopress_robots_primary_cat":"","_seopress_robots_breadcrumbs":"","_seopress_robots_freeze_modified_date":"","_seopress_robots_custom_modified_date":"","_seopress_robots_canonical":"","_seopress_social_fb_title":"","_seopress_social_fb_desc":"","_seopress_social_fb_img":"","_seopress_social_fb_img_attachment_id":0,"_seopress_social_fb_img_width":0,"_seopress_social_fb_img_height":0,"_seopress_social_twitter_title":"","_seopress_social_twitter_desc":"","_seopress_social_twitter_img":"","_seopress_social_twitter_img_attachment_id":0,"_seopress_social_twitter_img_width":0,"_seopress_social_twitter_img_height":0,"_seopress_redirections_value":"","_seopress_redirections_enabled":"","_seopress_redirections_enabled_regex":"","_seopress_redirections_logged_status":"both","_seopress_redirections_param":"","_seopress_redirections_type":301,"_seopress_analysis_target_kw":"","_seopress_news_disabled":"","_seopress_video_disabled":"","_seopress_video":[],"_seopress_pro_schemas_manual":[],"_seopress_pro_rich_snippets_disable_all":"","_seopress_pro_rich_snippets_disable":[],"_seopress_pro_schemas":[],"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","editor_notices":[],"footnotes":""},"class_list":["post-18675","documentation","type-documentation","status-publish","documentation_type-guias","product-seopress-pro"],"acf":[],"permalink_manager":null,"_links":{"self":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/18675","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/types\/documentation"}],"version-history":[{"count":3,"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/18675\/revisions"}],"predecessor-version":[{"id":25762,"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/18675\/revisions\/25762"}],"wp:attachment":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/media?parent=18675"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}