Hecho para agentes de IA, no solo navegadores: cómo funciona la API
Cada herramienta del catálogo es un endpoint REST bajo /api/v1/, más MCP en /mcp. Las llamadas anónimas no piden cuenta ni clave; los fallos traen problem+json.

Una pestaña del navegador sigue funcionando: eliges una herramienta, subes un archivo y descargas el resultado. Los agentes y los scripts llaman a las mismas operaciones sin abrir una interfaz. Los dos caminos llegan al mismo catálogo.
Cada página de herramienta es también un endpoint
Combinar, dividir, comprimir, OCR, convertir: cada herramienta del catálogo se corresponde con una ruta /api/v1/…. Abre la página de una herramienta y desplázate hasta Llámalo desde el código para ver un ejemplo de curl construido con los parámetros reales de esa herramienta, no una plantilla genérica. En el sitio público, las llamadas anónimas no necesitan cuenta ni clave de API; los prefijos anónimos son /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ y /api/v1/filter/.
El ejemplo de combinación es concreto:
curl -fsS -X POST "$API_BASE/api/v1/general/merge-pdfs" \
-F "[email protected]" \
-F "[email protected]" \
-o merged.pdf
La especificación OpenAPI está en /v1/openapi.json. El trabajo de varios pasos usa POST /api/v1/pipeline con una lista ordenada steps. Envía Idempotency-Key cuando un reintento no deba ejecutar dos veces un trabajo que modifica datos. Las respuestas alojadas anuncian X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset; ante un HTTP 429, lee Retry-After (límites de tasa anónimos).
El OCR del mismo catálogo devuelve Markdown (text/markdown) desde /api/v1/misc/ocr-pdf por defecto. Si envías outputFormat=pdf, ese mismo endpoint devuelve en su lugar un PDF buscable (application/pdf, hasta 50 páginas, reconocido con Tesseract). Un agente debería leer el Content-Type de la respuesta en vez de suponer una descarga de texto, porque las dos salidas vienen de motores distintos con límites distintos.
MCP para los clientes que lo hablan
MCP (Model Context Protocol) permite a los clientes de agente descubrir e invocar herramientas como funciones en lugar de raspar documentación. Este sitio expone un servidor MCP en /mcp, junto a la API REST, de modo que un cliente compatible se conecta una vez y obtiene el catálogo completo.
MCP y REST comparten las expectativas de autenticación: anónimas donde lo permitan los prefijos de herramienta, y claves de API para la automatización estable y para los servidores autoalojados con acceso restringido. Apuntar un agente a /mcp no es un producto distinto de apuntar curl a /api/v1/…. Documentación: MCP para desarrolladores.
Los errores están estructurados, no en prosa
Los fallos devuelven application/problem+json (estilo RFC 7807), no un 500 pelado ni un «algo salió mal». Cada respuesta trae un código estable (rate_limited, bad_request, invalid_document, missing_dependency y similares), una pista legible y, a menudo, un siguiente paso. Una persona puede leerlo por encima; un agente puede decidir si reintenta, cambia el archivo o se detiene sin que nadie tenga que interpretar una traza de pila.
Cuando quien llama es un script, esa estructura importa más que una página HTML de error amigable. Referencia: Errores para desarrolladores.
llms.txt es para las herramientas, no para el ranking
/llms.txt es un índice en texto plano de todas las herramientas (nombre, descripción breve y URL), generado a partir del mismo catálogo que alimenta el sitio. Los agentes de código y las herramientas de documentación pueden leerlo como un README. No es una palanca de posicionamiento en Google: Search ignora /llms.txt (fuentes: guía de Google para la optimización con IA). Como se genera automáticamente, no puede quedarse obsoleto en silencio como un archivo editado a mano.
El CLI y la skill comparten las mismas formas
pdfx es un cliente de esa misma superficie REST, apuntado a una URL base con una clave de API opcional, así que envía la petición multipart que enviaría curl en lugar de exponer un segundo catálogo. La skill publicada en /skills/pdf123.md documenta las formas de combinación y de pipeline para que los agentes tampoco inventen un segundo contrato. Cuatro clientes, un catálogo: La misma operación, cuatro clientes.
La ruta del navegador no cambia
Soltar un archivo en una pestaña sigue funcionando igual. La superficie adicional son esos mismos endpoints para un agente, un script o CI: el mismo procesamiento, sin una persona de por medio. El autoalojamiento mantiene esa superficie dentro de tu red (Self-host); el servicio alojado sigue siendo la vía de prueba anónima.
Referencia de la API: Swagger. Fundamentos para cualquiera de las dos vías: Ayuda y Desarrolladores.