Tu primer artículo con el AI Content Editor

El AI Content Editor es el banco de trabajo de Rankion para artículos que rankean en Google y, a la vez, son citados en ChatGPT/Perplexity. Esta guía te lleva desde la elección del keyword hasta la publicación.

Preparación — elegir keyword

Sin keyword no hay rumbo. Si aún no tienes uno, pasa brevemente por el Keyword Explorer y busca uno con buen search volume y dificultad aceptable. Cómo se hace está en Investigación de keywords con el Explorer.

Importante: elige un keyword principal más 3–5 términos secundarios semánticamente afines. El generador los usa para construir profundidad y relevancia.

Crear el artículo

En la UI: Content → AI Content Editor → Nuevo artículo. Selecciona tu proyecto, introduce un título de trabajo y el keyword principal. Vía API:

curl -X POST https://rankion.ai/api/v1/projects/{project_id}/articles \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Fuentes de proteína vegana 2026", "keyword": "proteínas veganas"}'

Respuesta: HTTP 201 con el ID del artículo. El artículo queda creado como borrador, todavía sin contenido.

Iniciar la generación

Ahora el paso principal. Pasa al generador keyword, tipo de artículo, longitud objetivo, tono e idioma:

curl -X POST https://rankion.ai/api/v1/articles/{id}/generate \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "proteínas veganas",
    "article_type": "guide",
    "target_length": 1500,
    "tone": "informativo",
    "language": "es"
  }'

Coste: 5 créditos. La llamada es asíncrona y responde de inmediato con HTTP 202 y un job_id. La generación real corre 30–90 segundos en background.

Valores válidos para article_type, entre otros: guide, listicle, how-to, comparison, landing-page. Más opciones en AI Content Editor.

Hacer polling hasta que esté listo

En la UI ves un estado en vivo (polling cada 5 s): puedes salir de la página y volver. Vía API haces polling al artículo:

curl https://rankion.ai/api/v1/articles/{id} \
  -H "Authorization: Bearer TU_TOKEN"

Mientras processing_status esté en processing, la generación sigue en marcha. Cuando llega a completed, content_html y content_markdown están rellenos.

Score y optimización

Antes de publicar: pasa el artículo por el scoring. El score mide SEO (factores on-page), GEO (capacidad de ser citado por LLMs), legibilidad y calidad estructural.

curl -X POST https://rankion.ai/api/v1/articles/{id}/score \
  -H "Authorization: Bearer TU_TOKEN"

Te devuelve 15–30 sugerencias concretas de mejora. Con /optimize puedes aplicarlas directamente — consulta AI Content Editor y API de Artículos.

Publicar

Si tienes una conexión con WordPress o Shopify configurada en el proyecto, puedes publicar directamente:

curl -X POST https://rankion.ai/api/v1/articles/{id}/publish \
  -H "Authorization: Bearer TU_TOKEN" \
  -d '{"target": "wordpress", "status": "draft"}'

Recomendamos un primer push como draft, luego revisión manual en el CMS, y finalmente live.

Consejos para mejores resultados

• Un keyword específico vence al genérico. «Fuentes de proteína vegana para deportes de fuerza» da artículos más nítidos que «proteína».
• Fija el tono — expertise, cercano, provocador. La consistencia gana a la arbitrariedad.
• Mantén el target-length realista. Long-form (>2000 palabras) requiere más profundidad semántica; en temas finos, mejor corto y conciso.
• Aprovecha el bucle de score: generate → score → optimize → re-score. Con tres rondas suele bastar para calidad de top ranking.
• Aporta tu propio conocimiento: introduce datos de marca, USPs y FAQs en el editor. El generador los toma con preferencia.

Continúa con Optimizar contenido para Google + IA para URLs existentes y Trackear AI-Visibility (ChatGPT, Perplexity, Gemini) para medir el impacto en búsquedas con IA.