Feature · Entrega
Los artículos aprobados llegan a tu repositorio como archivos con draft: true.
Cuando aprobás un artículo en seodraft, se commitea al repositorio de tu blog, en la ruta que configuraste y en el formato que lee tu CMS. La marca de borrador se escribe en cada entrega y nunca se borra nada de tu repositorio, así que lo que llega es un archivo esperando donde ya trabajás. La tarjeta de abajo es el destino que usa el blog de este sitio y el último borrador que recibió.
7 días gratis, sin tarjeta. Después $5 al mes si te suscribís.
¿Qué es un CMS basado en git?
Un CMS basado en git guarda tus posts como archivos en un repositorio de git, así que un artículo es un archivo Markdown en una ruta con un bloque de frontmatter arriba. Keystatic, las content collections de Astro, Hugo y Docusaurus funcionan de esa forma; cambian los nombres de las claves y la extensión, y el mecanismo de abajo es el mismo.
Por eso seodraft no tiene adaptadores de CMS. Un destino son cinco respuestas — repositorio, rama, plantilla de ruta, formato del cuerpo y la clave a la que se mapea cada campo canónico — y escribir un post es commitear un archivo por la API de Contents de GitHub.
Qué incluye
- Cinco respuestas
- Un destino es un repositorio, una rama, una plantilla de ruta, un formato de cuerpo y un mapeo de frontmatter, guardado una vez por workspace.
- Dos puntos de partida
- Keystatic viene completo; cualquier otro CMS basado en git arranca vacío y escribís vos mismo las cinco respuestas.
- La marca de borrador, forzada
- Cada entrega escribe draft: true encima de la marca del artículo, en la clave que use tu destino, y no hay opción para desactivarlo.
- Encabezados de Markdoc
- En archivos .mdoc el `## Título {#id}` que escribe el agente pasa a `{% #id %}`, que es la forma que Markdoc convierte en un atributo id.
- Reentrega segura
- Escribir la misma ruta otra vez pasa por el blob SHA del archivo, así que una segunda entrega lo actualiza en lugar de sumar uno.
- Un slug que se movió
- Se escribe la ruta nueva, el archivo viejo queda donde está y previousPath lo nombra para que lo borres vos.
Una entrega real
- Repositorio
- ch0rch/seodraft-app · rama main
- Preset
- Keystatic · formato de cuerpo .mdoc
- Plantilla de ruta
- content/blog/{locale}/{slug}.mdoc
- Archivo escrito
- content/blog/es/modelo-ia-respete-voz-marca.mdoc
- Mensaje del commit
- seodraft: draft "Cómo lograr que un modelo de IA respete la voz de mi marca"
- Frontmatter
- draft: true, encima del false del artículo
Mapeo de frontmatter
- title → title
- description → description
- date → publishedAt
- updatedDate → updatedAt
- tags → tags
- draft → draft
- tldr → tldr
- faqs → faqs
- image → nada
- translationKey → translationKey
Cómo llega un borrador a tu repositorio
Un borrador llega a tu repositorio en tres pasos, y el último ocurre dentro de tu propio CMS.
- 1
Aprobás el artículo. approve_post revisa la última corrida de reglas, marca el artículo como listo y lo entrega en la misma llamada.
- 2
seodraft commitea un archivo. Renombra el frontmatter a tus claves, saca los slots de imagen que nadie completó, fuerza draft: true y escribe el archivo en tu rama.
- 3
Lo terminás y lo publicás. Subís las imágenes que el artículo pidió, corregís lo que quieras y publicás desde tu CMS. Acá no hay herramienta de publicar.
Cuánto cuesta
La entrega no usa datos pagos y viene con el plan de $5 al mes. La credencial es tuya: un token fine-grained de GitHub limitado a ese único repositorio, con Contents en Read and write, encriptado en reposo como el par de DataForSEO.
Preguntas sobre la entrega
Respuestas cortas sobre publicar, sobre CMS que no son Keystatic y sobre entregar dos veces el mismo artículo.
- ¿seodraft publica el artículo?
- Escribe draft: true en cada entrega, encima de la marca del propio artículo y en la clave que use tu destino, y no hay una opción que lo desactive. Publicar es un acto que hacés en tu CMS.
- ¿Y si mi blog no es Keystatic?
- Arrancá del destino vacío y completá vos las cinco respuestas: repositorio, rama, plantilla de ruta, formato del cuerpo y la clave a la que se mapea cada campo canónico. Las content collections de Astro, Hugo y Docusaurus son el mismo mecanismo con otros nombres de clave.
- ¿Qué pasa si entrego dos veces el mismo artículo?
- Se escribe otra vez la misma ruta por el blob SHA del archivo, así que la segunda entrega lo actualiza. Si el slug cambió en el medio, se escribe la ruta nueva y previousPath nombra el archivo viejo, que queda en tu repositorio hasta que lo saques.
Relacionado
- Editor · Donde leés el borrador antes de aprobarlo.
- Calendario editorial · La cola de la que salió el artículo.
- Precios · Un plan, $5 al mes.