Por qué autoalojar un toolkit PDF en lugar de otro convertidor web gratis

Los convertidores PDF que solo funcionan en el navegador están optimizados para subir, hacer clic y descargar. A menudo los anuncios financian la página y, más allá del formulario, no suele haber una superficie estable para desarrolladores. Esa forma de producto es la correcta para una tarea humana puntual, y la equivocada cuando necesitas automatización, una política de retención o archivos que no deben salir de tu red.

Para qué están optimizados los convertidores de navegador

Un convertidor público vende comodidad: abrir una pestaña, soltar un archivo, obtener el resultado y marcharse. La interfaz es el producto. Los scripts o bien raspan HTML o bien llaman a endpoints sin documentar que cambian sin avisar. La retención depende de quien opere el almacén temporal. Para combinar dos PDF personales una sola vez, el intercambio compensa.

En cuanto necesitas la misma tarea desde CI, un agente o una red aislada, faltan piezas de golpe: autenticación, OpenAPI, reintentos idempotentes y un catálogo que no diverja en silencio del formulario que usaste la semana pasada.

Qué obtienes al ejecutar este catálogo por tu cuenta

El sitio alojado y una instancia autoalojada comparten las mismas operaciones. Comprimir y Combinar son las mismas ops tanto si la petición vino del portal como de POST /api/v1/…. Autoalojar añade control alrededor de ese catálogo compartido:

• REST + OpenAPI en /v1/openapi.json: cada herramienta del catálogo es un endpoint estable, no solo un formulario.
• MCP en /mcp: los agentes descubren y llaman las mismas operaciones sin inventarse raspadores.
• CLI (pdfx): un cliente de línea de comandos para la misma API, apuntado a tu URL base con una clave opcional.
• Sin cliente de escritorio: la vía offline es Docker Compose; los plugins y los instaladores de Windows quedan fuera de alcance a propósito.
• Los anuncios no entran en tu stack: el AdSense del sitio público no forma parte de un despliegue autoalojado. Las subidas no salen de las máquinas que tú operas.

Compose levanta juntos el pdfx-server de Rust y el portal de Next.js, de modo que personas y scripts comparten un catálogo. El desarrollo nativo (task pdfx:dev más el portal) usa la misma ruta de ops. Los detalles están en Self-host.

El OCR devuelve Markdown (text/markdown) desde /api/v1/misc/ocr-pdf en cualquiera de los dos despliegues, no un PDF buscable con capas nuevas. Mover el servidor cambia dónde aterrizan los bytes; no inventa otro contrato de operación.

Qué no copiamos a propósito

Los lienzos online de «editar PDF», la comparación visual, la creación de PDF en blanco y las interfaces de firma para consumidores requieren otro trabajo de producto. Nosotros mantenemos la matriz de herramientas basadas en formulario y la API. Autoalojar no desbloquea un segundo árbol de interfaz: traslada el mismo árbol detrás de tu cortafuegos.

Saltarse esas superficies de consumo es deliberado. Un editor de lienzo sería una segunda base de código con su propio retraso de funciones respecto a OpenAPI. La restricción que importa para el uso privado es «los bytes se quedan aquí», no «hay un .exe». Sobre por qué no hay versión de escritorio, consulta Por qué nos saltamos la app de escritorio.

Cuándo basta con el servicio alojado y cuándo no

Usa el sitio público cuando quieras cero configuración y una tarea anónima puntual. Las herramientas del catálogo y las llamadas anónimas a /api/v1/ no piden cuenta; las respuestas alojadas anuncian cabeceras de límite de tasa y existen topes para que la superficie gratuita no se convierta en la granja de lotes de otra persona (límites de tasa anónimos).

Autoaloja cuando lo exijan las reglas de retención, las redes privadas o la automatización privada. Entonces asumes tú la disponibilidad, las actualizaciones de imagen, el disco para archivos temporales, TLS y la rotación de claves (SECURITY_CUSTOMGLOBALAPIKEY para una puerta fija en tu máquina). Las operaciones no cambian; lo que cambia es dónde aterrizan los bytes.

Pruébalo

Empieza por Self-host y Desarrolladores. Para la superficie de API orientada a agentes en cualquiera de las dos URL base, lee Hecho para agentes de IA, no solo navegadores. Para un desglose más amplio de costes y beneficios, consulta Qué te compra realmente el self-hosting.