# Cómo publicar el HTML que genera tu agente (Claude Code, Cursor, Codex)

> Guía para que Claude Code, Cursor, Codex o cualquier agente publique páginas HTML en una URL propia, privada por default y con versiones, usando la API de Outbox.

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

## 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

- [Outbox vs Stacktree](https://out-box.dev/es/guides/vs/stacktree)
- [Outbox vs Claude Artifacts](https://out-box.dev/es/guides/vs/claude-artifacts)
- [Outbox vs Derive](https://out-box.dev/es/guides/vs/derive)

---

Actualizado el 2026-10-11. Versión HTML: https://out-box.dev/es/guides/publicar-html-desde-claude-code-cursor-codex