Content Optimizer

El Content Optimizer toma una URL existente — sea creada en Rankion o publicada externamente — scrapea el HTML live, puntúa SEO y GEO y entrega una lista priorizada de 15–25 sugerencias concretas de optimización. Cada sugerencia es atómica, tiene un impacto en el score y puede aceptarse o rechazarse de forma individual. Cuando aplicas, el optimizer escribe la nueva variante de vuelta (para artículos de Rankion) o te entrega un patch-diff listo (para URLs externas). Así elevas el contenido existente paso a paso a top-rankings, sin reescribir.

Qué puede hacer

• Escaneo de URL — scrapea cualquier URL live y analiza el estado actual del contenido.
• SEO + GEO Side-by-Side — señales on-page clásicas más Generative-Engine-Optimization (estructuras, citas, densidad fáctica) en un solo score.
• 15–25 sugerencias por análisis — atómicas, con justificación, delta de score y snippet de ejemplo.
• Adopción selectiva — eliges con suggestion_ids[] qué sugerencias se aplican, el resto queda pendiente.
• Pipeline async — análisis y apply corren como Queue-Jobs, la UI hace polling de estado.
• Versionado — cada apply-run crea una nueva versión del artículo (ver AI Content Editor), rollback en cualquier momento.
• Vista de diff — antes / después side-by-side antes de hacer commit.

Cuándo usarlo

• Tienes artículos en posiciones 8–15 que con pequeños ajustes alcanzan Top-3.
• Quieres llevar contenido antiguo al estándar GEO actual (citabilidad, estructura fáctica).
• Tienes un blog post externo cuyo potencial de optimización quieres cuantificar.
• Quieres mejorar de forma dirigida tras un aviso de penalty o refresh de Content Freshness.

Workflow

1. Envía la URL — POST /content-optimizer/analyze con la URL, respuesta 202 + id.
2. Polling de estado — GET /content-optimizer/{id} hasta status=completed.
3. Revisa las sugerencias — la response contiene sugerencias priorizadas con impacto en el score.
4. Hace tu selección — elige las sugerencias que quieres adoptar.
5. Aplica — POST /content-optimizer/{id}/apply con {suggestion_ids: [...]}.
6. Re-Score — se calcula un nuevo score SEO/GEO, el diff se hace visible.

Guía detallada en Optimizar contenido para Google + IA.

API

Ejemplo de body POST /content-optimizer/analyze:

{
  "url": "https://meinedomain.de/blog/stossdaempfer-wechseln"
}

Ejemplo de body POST /content-optimizer/{id}/apply:

{
  "suggestion_ids": [12, 14, 15, 17, 22]
}

Créditos y límites

• Analyze: 5 créditos por run.
• Apply: 5 créditos por run, independientemente del número de sugerencias adoptadas.
• Modelo async: ambos endpoints devuelven 202, resultado por polling.
• Las URLs externas se cargan vía servicio de scraping; contenidos protegidos (login-wall, bloqueo de bots) terminan en failed.

Módulos relacionados

• AI Content Editor — crea artículos nuevos en lugar de optimizar existentes.
• Content Freshness — detecta artículos desactualizados y dispara runs del optimizer.
• Content Audit — análisis a nivel de site en lugar de URL individual.
• Guía: Optimizar contenido — paso a paso.