Saltar al contenido
← Volver al blog

Convierte PDF a Markdown con PDFCraft MCP

Conecta un agente de IA a PDFCraft MCP, convierte un PDF de ejemplo a Markdown, comprueba el resultado y reutiliza el texto en resúmenes y tareas documentales.

OOMOL

Una persona leyendo un libro con luz natural y el título Lee más allá del PDF

Un informe en PDF puede servir como fuente para un agente de IA. Convertirlo a Markdown te da un archivo que puedes revisar, editar y reutilizar al pedir un resumen o extraer información.

PDFCraft ofrece un servicio MCP remoto para procesar PDF y EPUB. Este tutorial usa un pequeño PDF público para explicar los pasos desde la conexión hasta la revisión del Markdown descargado. La conversión consume créditos de PDFCraft.

Conecta PDFCraft a tu agente

Crea una clave de API en OOMOL Console y sigue la guía de conexión MCP de PDFCraft para añadir el servidor a tu agente. PDFCraft tiene su propio endpoint MCP: añádelo como un servidor independiente junto a las conexiones de aplicaciones de OOMOL que ya uses.

Antes de empezar, comprueba que tu cliente admite el transporte, la versión del protocolo y las cabeceras de autenticación Bearer indicados en la guía. Guarda la clave en la configuración protegida del cliente. El cliente también debe poder leer y subir el contenido del archivo: indicar un nombre de archivo local a un servidor remoto no sube el documento.

Pide al agente que llame a get_capabilities y explique los formatos de conversión disponibles. Si no puede descubrir las herramientas, resuelve la conexión antes de subir un archivo o iniciar una tarea de pago.

Empieza con un PDF de una página

Descarga y abre el PDF de ejemplo de PDFCraft. Contiene la frase Paper to structured text., que podrás buscar en el resultado. Es un archivo pequeño para practicar, no una prueba de calidad para libros escaneados, tablas o ecuaciones.

Adjunta el PDF mediante la interfaz de tu cliente o déjalo en un espacio de trabajo que el agente pueda leer. Después, pídele:

Usa PDFCraft para preparar la conversión del PDF adjunto a Markdown. Comprueba las opciones disponibles y mi saldo, estima el coste de conversión y muéstrame la estimación antes de iniciar el procesamiento. Conserva el UUID de la tarea para poder retomarla más adelante.

Revisa la estimación y autoriza el procesamiento cuando quieras continuar:

Inicia la conversión a Markdown. Consulta el progreso a intervalos hasta que termine y descarga el resultado completo en este espacio de trabajo. Indica el UUID de la tarea y dónde has guardado el archivo. Si falla, muestra el error antes de crear otra tarea.

El servicio crea una tarea, recibe el archivo, inicia el procesamiento, permite consultar el progreso y proporciona un enlace de descarga. Descubrir las herramientas no confirma que la subida o la conversión haya terminado correctamente. Conserva el UUID hasta haber guardado y revisado el resultado.

Comprueba el resultado antes de pedir un resumen

Abre el resultado descargado. Si es un archivo comprimido, extráelo y revisa el Markdown y los recursos que lo acompañan. Puedes pedir al agente:

Abre el Markdown convertido y comprueba si contiene «Paper to structured text.». Muestra el pasaje correspondiente y compáralo con el PDF de ejemplo. Señala cualquier texto que falte en lugar de completarlo.

Encontrar esa frase es una comprobación básica de que la salida corresponde al archivo esperado. Con tus propios documentos, compara los títulos, el orden de los párrafos, las tablas, los números y las notas al pie con el original. Un resumen legible puede ocultar un error de transcripción, sobre todo en un número o una ecuación.

Una vez revisada la conversión, puedes pedir al agente que trabaje con el texto guardado:

Resume este Markdown en cinco puntos. Incluye una cita breve que respalde cada punto y el título de la sección de origen, si está disponible. No modifiques el Markdown original.

El agente escribe el resumen a partir del resultado de la conversión. PDFCraft proporciona las herramientas de procesamiento de documentos. Puedes conservar el Markdown como fuente reutilizable sin volver a convertir el mismo PDF cada vez que hagas una pregunta.

Retoma una tarea interrumpida

Si la conversación o el cliente se detiene durante el procesamiento, proporciona el UUID guardado a la siguiente sesión y pídele que consulte esa tarea. No inicies otra conversión solo porque hayas perdido la vista de progreso de la primera sesión.

Si caduca un enlace de descarga, solicita otro para la misma tarea mientras sus archivos sigan disponibles. Si un saldo pendiente bloquea la descarga completa, añade créditos y vuelve a solicitar el resultado. La guía del ciclo de vida y recuperación de tareas explica los estados y las opciones de recuperación. Guarda los archivos terminados antes de que caduquen.

EPUB y traducción

PDFCraft también permite convertir PDF a EPUB y traducir PDF o EPUB. Si quieres leer un libro en un lector electrónico, solicita la salida en EPUB. Para traducir, pide al agente que compruebe los idiomas disponibles con get_capabilities, confirme el idioma de destino y estime el coste antes de procesar el archivo.

Elige el formato según el siguiente paso: Markdown para revisar y reutilizar texto, EPUB para leer un libro. Comprueba el resultado con un documento pequeño y representativo antes de iniciar una conversión mayor.

Usa el texto en tus aplicaciones de trabajo

Después de revisar el Markdown, puedes guardar un resumen en una aplicación de trabajo o adjuntarlo a un proyecto. Conecta la aplicación siguiendo la guía de inicio de agentes de OOMOL e indica el destino antes de pedir al agente que escriba allí. El servidor de conversión de PDFCraft y las aplicaciones conectadas a OOMOL se configuran por separado.

Para comprimir, combinar o dividir PDF en el navegador, abre las herramientas PDF en línea de PDFCraft. Para convertir documentos mediante un agente, empieza por la guía de conexión MCP de PDFCraft.