Subnano lanza una API de publicación para scripts, bots y agentes de IA
Subnano, la plataforma de publicación de pago por artículo en Nano, ahora es programable. El 6 de marzo, el desarrollador Noom lanzó una API de publicación que permite crear y publicar artículos desde scripts, aplicaciones o agentes de IA. Dice que la idea llevaba mucho tiempo dándole vueltas y que todo encajó cuando habilitó a su propio agente de IA, Pawl, para publicar en Subnano.
Qué hace la API
La API v1 está en https://subnano.me/api/v1 y se autentica con una clave API personal enviada como token Bearer. Cubre todo el ciclo de vida del artículo: crear, listar, consultar, actualizar y eliminar borradores; transiciones de publicar y despublicar; subida de imágenes para el contenido y las imágenes OG; y contenido en Markdown. La publicación es idempotente: reintentar con la misma Idempotency-Key reproduce la respuesta almacenada en lugar de crear duplicados.
La guía rápida de la documentación es corta: crear una clave API en los ajustes de Subnano, guardarla en un lugar seguro, crear un borrador y publicarlo. Todo el flujo empieza con una sola llamada curl:
curl -X POST "https://subnano.me/api/v1/posts"
-H "Authorization: Bearer $SUBNANO_PUBLISH_KEY"
-H "Content-Type: application/json"
-d '{
"title": "Agent draft",
"description": "Draft created via API",
"paidContentMarkdown": "# Hello from API\n\nDraft body.",
"enablePaywall": true,
"priceRaw": "100000000000000000000000000000",
"primaryCategoryId": 4,
"language": "en",
"commentsEnabled": true,
"creationMethod": "ai_assisted_research",
"creationDetails": "AI helped locate sources; the author reviewed and wrote the post.",
"creationAttested": true
}'
El ejemplo es revelador. Es un borrador con muro de pago a 0,1 XNO, ya que los precios se pasan en unidades raw, e incluye creationMethod: ai_assisted_research y creationAttested: true, una declaración de que el artículo fue revisado antes de publicarse. Ahora que publicar ya no exige necesariamente a un humano frente al teclado, ese tipo de metadatos importa.
Pensada para agentes
Junto a la API, Noom publicó un módulo de un solo archivo para agentes de IA en https://docs.subnano.me/skills/subnano-publishing-api/SKILL.md. Reúne los endpoints, las plantillas de datos JSON, las recetas curl, las reglas de subida de imágenes y el manejo de errores en un único documento que un agente puede cargar directamente, sin referencias adicionales. Su propio agente Pawl ya publica en Subnano a través de él.
Los casos de uso que menciona: agentes de IA que publican informes que se venden, bots que publican resúmenes diarios de investigación, pipelines de GitHub o CI que publican devlogs, y herramientas SaaS que usan Subnano como servidor de muros de pago impulsado por Nano.
Una capa de publicación programable
El movimiento encaja con la dirección que llevaba Subnano. La plataforma añadió soporte de x402 hace meses: x402 es el flujo de pago HTTP 402, una forma legible por máquinas para que apps y agentes soliciten y liquiden pagos, el mismo protocolo que sirve el facilitador x402nano.org en Nano. Junta eso con muros de pago instantáneos, pagos instantáneos a creadores y ahora una API de publicación, y Subnano se convierte en una capa de publicación programable. La propia definición de Noom: lista para la era de los agentes.
Primeros pasos
Las salvedades honestas: la API es nueva, el proyecto es de un solo desarrollador y el anuncio no incluye cifras de uso, así que todavía no hay nada con qué medir la adopción. Lo que existe es concreto: una API documentada, un módulo de agente funcional y una plataforma que paga a los creadores en XNO cuando un artículo se vende. La documentación recorre todo el contrato, el módulo para agentes merece la lectura si gestionas agentes, y la plataforma está en línea en subnano.me. Noom pidió comentarios, y para una API tan joven esa es probablemente la aportación más valiosa que puede recibir ahora mismo.