agentleFS
carlosuhartcarlosuhart/seo-audit-skills/skills/prestashop-seo/SKILL.md

prestashop-seo

Skill6 starsChanged 15 days agoMITView on GitHub

SEO en PrestaShop: issues recurrentes, backoffice, estructura de URLs, sitemap y performance. Usar cuando el sitio corre PrestaShop o se menciona "controlador", "CCC" o "1_index_sitemap".

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No hacer sin migración planificada — rompe todas las URLs existentes.

    line 116
  2. Very specific:

    Síntoma: No hay <link rel="canonical"> en la homepage.

    line 286

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

PrestaShop — Guía SEO Técnica

Verificado en PrestaShop 1.7.x / 8.x con PHP 8.1.x. Documentación oficial SEO: https://docs.prestashop-project.org/v.8-documentation/user-guide/configuring-shop/shop-parameters/traffic/seo-and-urls Documentación performance: https://docs.prestashop-project.org/v.8-documentation/user-guide/configuring-shop/advanced-parameters/performance


Contexto de plataforma

PrestaShop es un CMS e-commerce PHP con renderizado server-side (SSR). El contenido está en el HTML inicial — no requiere JS para ser indexado.

Diferencias clave vs WordPress:

  • Sin page builder nativo. El frontend usa Smarty templates. Algunos clientes instalan CreativeElements (clon de Elementor para PS) — genera los mismos problemas de CSS/JS que Elementor en WordPress.
  • El sistema de URLs incluye ID numérico por defecto en categorías: /217-ramos-de-flores en lugar de /ramos-de-flores.
  • El sitemap se genera como 1_index_sitemap.xml (no sitemap.xml).
  • Caché desactivada por defecto (Cache-Control: no-store) — issue crítico.
  • robots.txt generado automáticamente por PrestaShop con bloqueo de parámetros de consulta y controladores internos.

Stack técnico habitual:

PrestaShop 8.x + PHP 8.1.x + Nginx/Plesk
+ CreativeElements (page builder opcional)
+ Google Analytics / GTM
+ Facebook Pixel
+ Módulo de sitemap nativo de PrestaShop
Hosting: Plesk / servidor dedicado / VPS

Rutas de configuración en el backoffice

SecciónRuta
Friendly URLs / SEO & URLsShop Parameters > Traffic & SEO > SEO & URLs
Robots.txt generatorShop Parameters > Traffic & SEO > SEO & URLs (al final)
CCC (CSS/JS cache)Advanced Parameters > Performance > CCC
Smarty cacheAdvanced Parameters > Performance > Smarty
Server-side cache (Memcache/Redis)Advanced Parameters > Performance > Caching
Sitemap XMLCatalog > (módulo de sitemap) o Modules > Sitemap
Meta tags por páginaShop Parameters > Traffic & SEO > SEO & URLs > lista de páginas
Canonical redirectShop Parameters > Traffic & SEO > SEO & URLs > "Redirect to Canonical URL"

Issues recurrentes — Detección y solución

sitemap.xml devuelve 404 (CRÍTICO — frecuencia: muy alta)

Síntoma: https://dominio.com/sitemap.xml → HTTP 404.

Causa: PrestaShop genera el sitemap en una ruta no estándar: /1_index_sitemap.xml (o 1_[lang]_[shop]_sitemap.xml). La ruta estándar /sitemap.xml no existe salvo que se configure explícitamente.

Impacto: Google Search Console y la mayoría de crawlers prueban /sitemap.xml primero. El sitemap real puede quedar sin descubrir si no está declarado en robots.txt.

Verificación: curl -I https://dominio.com/sitemap.xml

Solución A — Redirect en Nginx:

location = /sitemap.xml {
    return 301 https://dominio.com/1_index_sitemap.xml;
}

Solución B — Redirect en .htaccess (Apache):

RedirectPermanent /sitemap.xml https://dominio.com/1_index_sitemap.xml

Solución C — Verificar que robots.txt declara la ruta correcta:

Sitemap: https://dominio.com/1_index_sitemap.xml

URLs con ID numérico en categorías (ALTO — estructura)

Síntoma: Categorías en formato /217-ramos-de-flores en lugar de /ramos-de-flores. La URL limpia devuelve 404.

Causa: PrestaShop incluye el ID de categoría en la URL por defecto para garantizar unicidad interna. Es el comportamiento estándar del sistema Friendly URLs de PrestaShop.

Impacto: URLs no limpias, difíciles de gestionar en migraciones. Sin embargo, la canonical en la página apunta a la URL con ID — no hay duplicado. El impacto SEO directo es bajo pero afecta usabilidad y migración futura.

Verificación: El canonical en la página de categoría debe apuntar a la URL con ID numérico (correcto). Si hay dos versiones accesibles (con y sin ID) ambas con 200, hay problema de duplicado.

Solución (si se decide eliminar IDs):

  • Backoffice: Shop Parameters > Traffic & SEO > Schema of URLs
  • Requiere plan de migración completo: 301 redirects de todas las URLs con ID a las nuevas URLs limpias antes de cambiar la configuración.
  • No hacer sin migración planificada — rompe todas las URLs existentes.

Nota: Si el cliente no tiene historial de backlinks ni tráfico significativo en URLs con ID, la migración tiene bajo riesgo. Si tiene backlinks, priorizar la migración con herramienta de redirects.


Cache-Control: no-store en todas las páginas (CRÍTICO — CWV)

Síntoma: Cabecera Cache-Control: no-store, no-cache, must-revalidate en todas las respuestas HTML.

Causa: PrestaShop desactiva el caché de HTML por defecto porque las páginas pueden contener datos de sesión del usuario (carrito, precios por grupo, etc.).

Impacto: Cada visita requiere un round-trip completo al servidor. Directo sobre LCP y TTFB. Especialmente grave para Googlebot y usuarios en conexiones lentas.

Solución — Activar CCC en PrestaShop: Ruta: Advanced Parameters > Performance > CCC (Combine, Compress, Cache)

Opciones a activar:

OpciónAcción
Smart cache for CSSActivar — combina + comprime CSS
Smart cache for JavaScriptActivar — combina + comprime JS
Minify HTMLActivar — elimina whitespace del HTML
Compress inline JavaScript in HTMLActivar
Move JavaScript to the endActivar — mueve JS al final del body
Apache optimizationActivar si el servidor lo soporta

Solución complementaria — Smarty cache: Ruta: Advanced Parameters > Performance > Smarty

OpciónValor recomendado en producción
Cache compilation"Never recompile template files"
CacheEnabled
Caching typeFile system (por defecto)

Solución avanzada — Full-page cache: Para sitios con tráfico alto, añadir Varnish o módulo de full-page cache. El módulo oficial de PrestaShop soporta Memcached y Redis para object cache (Advanced Parameters > Performance > Caching).

Advertencia: Activar CCC puede romper temas personalizados. Probar en staging antes de producción.


URLs de controladores en el sitemap (CRÍTICO)

Síntoma: El sitemap incluye URLs como:

  • index.php?controller=module-creativeelements-ajax
  • index.php?controller=module-creativeelements-preview
  • index.php?controller=product
  • index.php?controller=category

Causa: El módulo de sitemap de PrestaShop (o CreativeElements) añade endpoints internos AJAX/preview al sitemap.

Impacto: Google indexa o intenta indexar endpoints internos que devuelven contenido vacío o de error. Desperdicio de crawl budget.

Solución A — Excluir desde el módulo de sitemap:

  • Modules > Sitemap Generator > configurar qué tipos de páginas se incluyen
  • Desactivar "Module pages" o "CMS pages" si incluyen controllers no deseados

Solución B — Bloquear en robots.txt:

Disallow: /*controller=module-creativeelements-ajax
Disallow: /*controller=module-creativeelements-preview
Disallow: /*controller=product$
Disallow: /*controller=category$

Nota: robots.txt de PrestaShop se regenera desde el backoffice: Shop Parameters > Traffic & SEO > Generate robots.txt. Editar el archivo físico puede sobrescribirse. Añadir reglas via el campo "Custom robots.txt" si está disponible, o mediante hook actionHtaccessCreate.


CSS/JS excesivos — sin CCC activo (CRÍTICO — CWV)

Síntoma: 30-50 archivos CSS y 20+ JS cargados en cada página.

Causa: PrestaShop carga un archivo CSS/JS por módulo. Sin CCC activo, cada módulo instalado añade sus assets de forma independiente.

Issues específicos observados:

  • ceicons.min.css cargado dos veces (bug de CreativeElements)
  • Google Fonts externo sin font-display: swap
  • jQuery sin defer (al final del body por defecto en PS, pero bloquea si está en head)
  • Font Awesome en múltiples bundles (FA brands + FA solid + eicons)

Solución principal: Activar CCC (ver sección anterior).

Solución complementaria — Google Fonts: Autoalojamiento via Google Fonts Helper (gwfh.mranftl.com) o añadir &display=swap al URL de Google Fonts + preconnect:

<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>

Duplicate CSS fix: Auditar el fichero de registro del módulo problemático en /modules/[nombre]/views/templates/hook/ y eliminar el registerStylesheet duplicado.


Hero como CSS background-image (ALTO — LCP)

Síntoma: La imagen hero del slider usa background-image en estilo inline del contenedor (habitual con CreativeElements o el módulo homeslider nativo).

Causa: Los sliders de PrestaShop (homeslider, LayerSlider, CreativeElements) usan background-image CSS por defecto.

Impacto: Imagen no visible para el preload scanner → LCP elevado.

Solución:

<!-- En el template Smarty del tema, añadir en <head>: -->
<link rel="preload" as="image"
      href="{$hero_image_url}"
      fetchpriority="high">

O via hook displayHeader en un módulo personalizado:

// En el módulo o override de tema:
public function hookDisplayHeader($params) {
    return '<link rel="preload" as="image"
            href="' . $this->context->link->getMediaLink('/img/cms/hero.jpg') . '"
            fetchpriority="high">';
}

PHPSESSID con expiración de décadas (MEDIO — GDPR)

Síntoma: Set-Cookie: PHPSESSID=...; expires=...-2082.

Causa: Configuración por defecto de PrestaShop con session.gc_maxlifetime excesivo.

Impacto: GDPR / ePrivacy — cookie de sesión con expiración de 56 años. Puede ser observación de auditoría AEPD.

Solución en php.ini o .user.ini:

session.cookie_lifetime = 0          ; cookie de sesión (sin expires)
session.gc_maxlifetime = 3600        ; 1 hora de inactividad

O en PrestaShop via parameters.php o config/defines.inc.php:

ini_set('session.cookie_lifetime', 0);

Canonical ausente en homepage (CRÍTICO si ocurre)

Síntoma: No hay <link rel="canonical"> en la homepage.

Causa: Bug en tema o módulo que no inyecta el canonical en la raíz.

Impacto: Riesgo de duplicados via parámetros de URL (?id_currency=, ?back=, ?controller=index).

Solución en template Smarty (head.tpl o equivalente):

<link rel="canonical" href="{$urls.current_url|escape:'html':'UTF-8'}" />

O usar el módulo SEO integrado de PrestaShop que lo gestiona automáticamente.


Multiple H1 en homepage (ALTO si ocurre)

Causa: Sliders y módulos de sección arrastran H1 a títulos de carrusel.

Verificación: document.querySelectorAll('h1') en DevTools.

Solución: Cambiar etiquetas de sección/carrusel de H1 a H2 en el template Smarty o en la configuración del módulo de slider.


Open Graph / Twitter Card ausentes (ALTO)

Causa: PrestaShop no genera OG tags por defecto. Requiere módulo SEO o implementación manual en el tema.

Solución — en template Smarty:

<meta property="og:title" content="{$page.meta.title|escape:'html':'UTF-8'}" />
<meta property="og:description" content="{$page.meta.description|escape:'html':'UTF-8'}" />
<meta property="og:url" content="{$urls.current_url|escape:'html':'UTF-8'}" />
<meta property="og:image" content="{$og_image_url|escape:'html':'UTF-8'}" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary_large_image" />

Seguridad — headers (variable)

Solución Nginx:

add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;

CSP con PrestaShop: Compleja por el número de third-parties habituales. Comenzar en modo report-only:

add_header Content-Security-Policy-Report-Only "default-src 'self';
  script-src 'self' 'unsafe-inline' *.googletagmanager.com *.google-analytics.com
  *.facebook.net *.facebook.com;
  img-src 'self' data: https:;
  style-src 'self' 'unsafe-inline' fonts.googleapis.com;
  font-src 'self' fonts.gstatic.com;" always;

X-Powered-By en Plesk + Nginx:

fastcgi_hide_header X-Powered-By;

En php.ini: expose_php = Off


Schema Product + Offer (e-commerce)

PrestaShop genera Product schema automáticamente en versiones recientes si está habilitado en las preferencias del módulo. Verificar si el módulo SEO nativo lo genera o si requiere override.

AggregateRating requiere tener el módulo de valoraciones activo y configurado para exportar datos al JSON-LD.


Multistore — implicaciones SEO (MEDIO)

PrestaShop Multistore permite gestionar varias tiendas desde una única instalación. Cada tienda puede tener su propio dominio, idioma y catálogo.

Estructura habitual:

Tienda principal: dominio.com         (ES — España)
Tienda secundaria: dominio.com/en/    (EN — Internacional)
Tienda secundaria: dominio.mx/        (ES-MX — México)

Issues SEO específicos de Multistore:

  1. Sitemap por tienda: PrestaShop genera un sitemap independiente por tienda. Cada tienda debe tener su sitemap declarado en su propio robots.txt.
    dominio.com/robots.txt → Sitemap: https://dominio.com/1_index_sitemap.xml
    dominio.com/en/robots.txt → Sitemap: https://dominio.com/en/1_en_index_sitemap.xml
    Verificar que cada robots.txt declara solo el sitemap de su tienda, no el global.
  2. Crawl budget fragmentado: Googlebot trata cada tienda como un sitio independiente si tienen dominios distintos. Con subdirectorios (dominio.com/en/), comparten crawl budget del dominio principal. Con subdominios o dominios separados (dominio.mx), el budget se separa.
  3. Hreflang obligatorio: Si múltiples tiendas sirven el mismo contenido en distintos idiomas o regiones, implementar hreflang entre ellas es crítico para evitar que Google duplique el contenido entre tiendas.

    PrestaShop no genera hreflang nativo en Multistore. Opciones:

    • Módulo de hreflang de terceros
    • Implementación manual en header.tpl de cada tema por tienda
    • Hook displayHeader en módulo personalizado
  4. Canonical en productos compartidos: Si el mismo producto aparece en múltiples tiendas (catálogo compartido), las URLs son diferentes: dominio.com/producto-X y dominio.com/en/product-X. Verificar que el canonical apunta a la versión correcta en cada tienda.
  5. robots.txt generado automáticamente por tienda: PrestaShop genera robots.txt por tienda en el backoffice. Ir a: Shop Parameters > Traffic & SEO > Generate robots.txt Hacer esto para cada tienda activa de forma independiente.
  6. Duplicación de páginas CMS: Páginas de política de privacidad, términos y condiciones, etc. suelen ser idénticas en todas las tiendas. Usar canonical cross-store o noindex en las versiones secundarias si el contenido es idéntico.

IndexNow en PrestaShop (MEDIO)

Solución: Módulo de terceros disponible en PrestaShop Addons. Alternativamente, implementar via API manualmente en el hook actionObjectProductUpdateAfter:

public function hookActionObjectProductUpdateAfter($params) {
    $url = $this->context->link->getProductLink($params['object']);
    $key = 'TU_CLAVE_INDEXNOW';
    file_get_contents("https://api.indexnow.org/indexnow?url={$url}&key={$key}");
}

Checklist de auditoría técnica para sitios PrestaShop

CRÍTICO
[ ] sitemap.xml: ¿devuelve 200 o 404? Si 404, ¿hay redirect o declaración en robots.txt?
[ ] Cache-Control: ¿"no-store" en páginas HTML? → activar CCC
[ ] Controllers en sitemap: ¿hay URLs ?controller= en el sitemap?
[ ] Canonical: ¿presente en homepage?
[ ] H1: ¿uno solo por página?

ALTO
[ ] URLs de categoría: ¿formato /ID-slug? ¿la versión sin ID devuelve 404 (correcto) o 200 (duplicado)?
[ ] Hero image: ¿background-image CSS o <img>? ¿hay preload link?
[ ] CCC: ¿activado? (Advanced Parameters > Performance)
[ ] CSS count: ¿30+ archivos? → indica CCC inactivo
[ ] Open Graph: ¿presente en todas las páginas?
[ ] Twitter Card: ¿presente?
[ ] og:image: ¿presente y ≥1200×630px?
[ ] Security headers: HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy
[ ] X-Powered-By: ¿eliminado?
[ ] PHPSESSID: ¿expiración razonable? (no décadas)

MEDIO
[ ] Product schema: ¿presente con Offer (price, availability, currency)?
[ ] AggregateRating: ¿módulo de valoraciones activo y exportando a JSON-LD?
[ ] LocalBusiness schema en homepage (si aplica al tipo de negocio)
[ ] SearchAction schema (WebSite)
[ ] robots.txt: ¿política de AI crawlers definida?
[ ] IndexNow: ¿módulo instalado?
[ ] Google Fonts: ¿externo o self-hosted?
[ ] CSS duplicado: verificar si hay stylesheets cargados 2 veces
[ ] Product images: ¿alt text en todos los productos?
[ ] Buscador / search page: ¿noindex?
[ ] Páginas funcionales (/pedido-rapido, /registro, /iniciar-sesion): ¿noindex?

BAJO
[ ] meta keywords: ¿vacíos o eliminados?
[ ] Theme path expuesto (/themes/[nombre]/): información disclosure menor
[ ] lastmod en sitemap: ¿actualizado en cada cambio?
[ ] /rows u otras URLs inexplicadas en sitemap
[ ] HTML lang attribute: formato correcto ("es" no "lang-es")

Positivos habituales en sitios PrestaShop bien configurados

  • SSR confirmado: contenido visible sin JS (ventaja directa vs JS-heavy CMSs)
  • HSTS con preload (max-age=31536000; includeSubDomains; preload)
  • Security headers completos (cuando el hosting tiene configuración dedicada)
  • Product schema con Offer bien implementado (generado nativamente por PS)
  • BreadcrumbList correcto en páginas de producto
  • Canonical self-referencing en producto y categoría
  • Canonical coherente con URL numérica en categorías (sin duplicados)
  • HTTPS enforced con 301 HTTP→HTTPS y www→no-www en un solo hop
  • robots.txt generado automáticamente por PrestaShop con bloqueo de parámetros de carrito, búsqueda y sesión

Referencias clave PrestaShop

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.