Cómo publicar el HTML que genera tu agente (Claude Code, Cursor, Codex)
Los agentes generan reportes, demos y dashboards en HTML todo el tiempo, y casi siempre terminan perdidos en una carpeta local o en un chat. Con Outbox cada uno queda en una URL propia, privada por default y con historial, ordenado en tu biblioteca. Podés publicar desde la API, el servidor MCP, la CLI o la skill; el resultado es el mismo.
Elegí cómo publica tu agente
| Canal | Cómo se conecta | Ideal para |
|---|---|---|
| Servidor MCP | Connector remoto (OAuth) o npx @out-box/mcp con una key | Claude, Cursor y cualquier cliente MCP |
| Skill | npx skills add jonathanleiva15/out-box-skills | Agentes de código con skills |
| CLI | npm install -g @out-box/cli y outbox setup | Terminal, scripts y CI |
| API HTTP | POST /publish con una API key | n8n, Zapier, backends y cualquier lenguaje |
1. Creá una API key para el agente
En Outbox, en Ajustes → Keys, creá una key para el agente. Podés limitarla a una carpeta para que ese agente solo publique ahí, y elegir un preset de solo publicar si no tiene que leer ni compartir. Con el connector remoto o la skill no hace falta copiar una key: te logueás en el navegador.
2. Publicá
Un POST con el HTML (o markdown) alcanza. El slug define la URL y la carpeta; si no lo mandás, Outbox genera uno. El campo model, con el modelo que generó el contenido, es obligatorio. Funciona igual desde Claude Code, Cursor, Codex, un script o n8n.
curl -X POST https://api.out-box.dev/publish \
-H "Authorization: Bearer $OUTBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"slug":"reportes/ventas-semana-40","title":"Ventas · semana 40","markdown":"# Ventas\n...","model":"claude"}'Lo mismo desde la CLI
La CLI hace el login en el navegador con outbox setup y publica un archivo con un comando.
npm install -g @out-box/cli outbox setup outbox publish reporte.html --slug reportes/ventas-semana-40 --model claude
3. Volvé a publicar en el mismo slug para actualizar
Si el agente publica de nuevo en el mismo slug, la URL no cambia y se guarda una versión nueva. Outbox conserva las últimas 15 versiones: podés ver el diff entre ellas y volver atrás. Al republicar se heredan el título, los tags y la visibilidad, salvo que los mandes de nuevo.
4. Decidí quién lo ve
Cada página nace privada. Podés pasarla a unlisted (solo con el link), a pública (aparece en tu perfil), o compartirla con un link por persona, con passphrase y vencimiento. Cuando compartís con un destinatario, te llega un mail cuando lo abre.
Qué conviene saber antes de automatizar
HTML o Markdown: el HTML se sirve tal cual, aislado; el Markdown se renderiza del lado del servidor con tu template. Peso: hasta 10 MB por página en Free y 25 MB en los planes pagos. Volumen: Free permite 10 publicaciones por día, Pro 100 y Pro+ 500.
Secretos: si el contenido parece tener credenciales, la respuesta trae un aviso; con rejectOnSecrets: true la publicación se rechaza antes de escribir nada. Para reportes que se repiten, un daily document mantiene una URL fija que el agente reescribe cada día.
Comparativas
Preguntas frecuentes
¿Outbox sirve el JavaScript de mi página?
Sí, el HTML se sirve tal cual, en un entorno aislado. Outbox no corre backend: es para páginas estáticas, no para apps con base de datos.
¿Puedo publicar desde un job de CI?
Sí, con la CLI o la API y una key limitada a una carpeta.
¿Qué pasa si dos agentes publican el mismo slug a la vez?
Cada publicación queda como una versión. Si querés evitar pisar cambios, mandá expectedVersion y Outbox rechaza la publicación si alguien se adelantó.
Guías relacionadas
Actualizado el 2026-10-11.