Feature · El harness
Los artículos aprobados llegan a tu repositorio como archivos con draft: true.
7 días gratis, sin tarjeta. Después $9 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 el agente no puede sacarla: solo tu clic en Publicar, en seodraft, deja el artículo publicado.
- 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 es tuyo.
- 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, con un clic en seodraft o desde tu CMS. El agente nunca publica.
Cuánto cuesta
La entrega no usa datos pagos y viene con el plan de $9 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?
- No por su cuenta. Cada entrega escribe draft: true, encima de la marca del propio artículo y en la clave que use tu destino, y el agente no puede cambiarlo. Publicar es un acto tuyo: un clic en Publicar en seodraft, o el botón de publicar de 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, $9 al mes por un workspace con hasta 3 personas, más $5 por cada workspace extra.
- Blog en Astro para un SaaS · Seis pasos para un blog en Astro donde los borradores del agente llegan con draft: true.