PDF Tools

Enderezar PDF

Detecta y corrige automáticamente páginas PDF inclinadas. Preserva las páginas de texto como contenido vectorial buscable y solo rasteriza las páginas de imagen (p. ej. escaneos).

file· Resultado de archivoAbrir herramienta

Inicio rápido

Llama a esta herramienta desde tu código en tres lenguajes.

cURL

# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/pdf-deskew' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"sourceFile.ext","contentType":"application/octet-stream","size":12345}'

# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
  --data-binary @/path/to/file.ext

# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/es/api/tools/pdf-deskew' \
  -F 'sourceFile=/public/samples/pdf/sample-multipage.pdf' \
  -F 'mode=auto' \
  -F 'manualAngle=0' \
  -F 'threshold=0.5' \
  -F 'rasterizeText=false' \
  -F 'pageRange='

Referencia de la API

Envía una petición POST con tus entradas en JSON. Los parámetros de tipo archivo requieren una subida previa.

Endpoint

HTTP

POST https://api.elysiatools.com/es/api/tools/pdf-deskew

Parámetros

Nombre	Tipo	Obligatorio	Descripción
sourceFile	filesubida requerida	Sí	—
mode	select	Sí	—
manualAngle	number	No	Ángulo de corrección manual (grados). Valor positivo corrige inclinación horaria. Solo en modo manual.
threshold	number	No	Ángulo mínimo de inclinación detectado (en grados) requerido para aplicar corrección en modo automático. Valores menores detectan inclinaciones sutiles.
rasterizeText	select	No	Por defecto las páginas de texto se preservan como contenido vectorial buscable (sin enderezar). Actívalo solo si necesitas enderezar contenido de texto vectorial, asumiendo la pérdida de la capacidad de selección de texto.
pageRange	text	No	Especifica páginas a enderezar (ej. 1-3,5,7-9). Dejar en blanco para todas.

Los parámetros de tipo archivo deben subirse primero mediante POST /upload/pdf-deskew; el filePath devuelto se pasa luego al campo correspondiente.

Formato de respuesta

Resultado de archivo

JSON

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}

Integración MCP

Añade esta herramienta a tu servidor Model Context Protocol para que los agentes de IA puedan listarla y llamarla.

Configuración del servidor

Añade este bloque a la configuración de tu cliente MCP:

mcp.json

{
  "mcpServers": {
    "elysiatools-pdf-deskew": {
      "name": "pdf-deskew",
      "description": "Detecta y corrige automáticamente páginas PDF inclinadas. Preserva las páginas de texto como contenido vectorial buscable y solo rasteriza las páginas de imagen (p. ej. escaneos).",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=pdf-deskew",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Listar herramientas disponibles

Tras conectar al endpoint SSE, lista las herramientas expuestas:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Llamar a esta herramienta

Invoca la herramienta por su id; los argumentos se construyen a partir de sus parámetros:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "pdf-deskew",
    "arguments": {
  "sourceFile": "/public/samples/pdf/sample-multipage.pdf",
  "mode": "auto",
  "manualAngle": 0,
  "threshold": 0.5,
  "rasterizeText": "false",
  "pageRange": ""
}
  }
}

Encadena varias herramientas en una sesión con una lista toolId separada por comas, p. ej. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20).

Los parámetros de archivo aceptan únicamente una URL de archivo pública (https://…). No se admiten rutas locales, data: URI ni cadenas Base64.

¿Dudas o problemas? Contacta con [email protected]