Aviso: soy el desarrollador de Eddocu, el producto del que hablo.
Llevo tiempo construyendo Eddocu, un editor de PDF, DOCX y PPTX con su propio motor de documentos (no es un envoltorio de otro programa). Funciona en el navegador y en Mac, Windows, Linux, iPhone/iPad y Android, y las apps funcionan sin conexión.
Los agentes de IA escriben bien el texto de un informe o una presentación; lo pesado es convertirlo en páginas de verdad. Para eso Eddocu tiene una API REST pequeña: el agente crea un documento o una presentación y lo construye página a página.
Para que quede claro el alcance: la API crea documentos y añade, reemplaza, borra y lee páginas. No edita PDF existentes, no convierte y no exporta.
La API
La especificación OpenAPI 3.1 es pública:
curl -s https://eddocu.com/api/v1/ai-tools/openapi.json | jq '.paths | keys'
| Método | Ruta | Qué hace |
|---|---|---|
| POST | /api/v1/ai-tools/documents |
Crea un documento (documentType: slide o doc) |
| POST | /api/v1/ai-tools/documents/{documentId}/pages |
Añade una página |
| PUT | /api/v1/ai-tools/documents/{documentId}/pages/{pageId} |
Reemplaza el contenido de una página |
| DELETE | /api/v1/ai-tools/documents/{documentId}/pages/{pageId} |
Borra una página |
| GET | /api/v1/ai-tools/documents/{documentId} |
Lee la información del documento |
Las llamadas van a https://app.eddocu.com con autenticación Bearer. La clave empieza por eddocu_ak_ y se crea en los ajustes de la cuenta.
Cada página es HTML posicionado
La página se envía como HTML con posiciones absolutas y el motor lo convierte a su propio formato de página:
- un único
<div>raíz conposition:relativeywidth/heighten px - un
idúnico en cada elemento - todos los hijos con
position:absoluteyleft,top,width,heighten px - el texto va en un
class="textbox", con unclass="line"por línea - las imágenes son
<img>solo conalt(sinsrc; la imagen se genera a partir de la descripción) - las formas son
<div>normales con fondo o borde - tamaños por defecto: diapositiva 1920×1080, documento 816×1056 (US Letter)
Ejemplo mínimo
export EDDOCU_KEY=eddocu_ak_xxxxxxxx # tu clave
# 1. Crear una presentación
curl -s -X POST https://app.eddocu.com/api/v1/ai-tools/documents \
-H "Authorization: Bearer $EDDOCU_KEY" -H "Content-Type: application/json" \
-d '{"title":"API test","documentType":"slide"}'
# => {"documentId": 123, "accessToken": "..."}
# 2. Añadir una página
curl -s -X POST https://app.eddocu.com/api/v1/ai-tools/documents/123/pages \
-H "Authorization: Bearer $EDDOCU_KEY" -H "Content-Type: application/json" \
-d '{
"width": 1920, "height": 1080,
"html": "<div id=\"0\" style=\"position:relative;width:1920px;height:1080px;background:#ffffff;\"><div id=\"1\" class=\"textbox\" style=\"position:absolute;left:120px;top:100px;width:1200px;height:auto;\"><div class=\"line\"><span style=\"font-size:64px;font-weight:700;color:#1e293b;\">Hola, API</span></div></div><div id=\"2\" style=\"position:absolute;left:120px;top:200px;width:120px;height:6px;background:#3b82f6;\"></div></div>"
}'
# => {"pageId": "...", "nodeCount": 3}
Si haces demasiadas llamadas recibes 429: espera los segundos que indica la cabecera Retry-After.
Si un LLM genera las páginas, pon las reglas de HTML de arriba en su prompt de sistema y te devolverá HTML listo para enviar. Las mismas reglas están en el description de la especificación, así que un agente que lee OpenAPI puede trabajar solo con ella.
El servidor MCP (pequeño y de solo lectura)
También hay un servidor MCP en https://eddocu.com/mcp (Streamable HTTP, sin cuenta). Es de solo lectura y tiene dos herramientas: about_eddocu (datos públicos: plataformas, qué es gratis, precios, herramientas online, blog) y get_app_link (enlace de instalación para iOS, Android, Windows o Mac). No toca documentos.
claude mcp add --transport http eddocu https://eddocu.com/mcp
Pruébalo
Más sobre agentes y la API: https://eddocu.com/agents
El editor es gratis para uso personal y sin marca de agua. Hoy lo usan 500 personas (100 cada día) y se han abierto o editado 10 000 documentos.
La API todavía está tomando forma. Me encantaría leer qué endpoint les falta o qué HTML no pasa bien. Déjenlo en los comentarios.
Top comments (0)