--- seo_title: Plugin de Dify para web y conversión de archivos | EnConvert meta_desc: Instala el plugin de EnConvert para Dify desde su release de GitHub: seis herramientas para leer una página como markdown, mapear un sitio y convertir archivos. keywords: plugin de dify, dify scraping web, dify url a markdown, dify buscar en la web con un agente, dify convertir archivo a pdf, dify convertir docx a markdown, instalar plugin de dify desde github, dify difypkg, dify force verifying signature, plugin de enconvert para dify, dify extracción de datos estructurados --- # Plugin de Dify para páginas web y conversión de archivos El plugin de EnConvert para [Dify](https://dify.ai) añade seis herramientas a cualquier agente o workflow: leer una página web como markdown, buscar en la web, listar las URLs de un sitio, extraer campos estructurados y convertir un archivo subido a markdown o PDF. Cada renderizado de página lleva una puntuación `render_quality` de 0.0 a 1.0, así que una página de verificación o el cascarón vacío de una single-page-app llega marcada en lugar de razonarse como si fuera contenido real.
Paquete: enconvert · Fuente: enconvert/dify-enconvert · Dify mínimo: 1.0.0 · Licencia: MIT
--- ## Las seis herramientas | Herramienta | Endpoint | Qué hace | |------|----------|--------------| | **Perceive URL** | `POST /v2/perceive` | Renderiza una página en markdown, HTML limpio, HTML crudo, una captura de pantalla, un PDF, enlaces, imágenes o datos estructurados, con una puntuación `render_quality`. Construido sobre [Perceive](/es/docs/endpoints/perceive.md). | | **Web Search** | `POST /v2/lookup` | Búsqueda web, de noticias, de imágenes, académica, de patentes y de mapas, que devuelve título, URL, fragmento y posición. Construido sobre [Lookup](/es/docs/coming-soon/lookup.md). | | **Discover URLs** | `POST /v2/discover` | Lista las URLs de un sitio por sitemap, por rastreo o por ambos, sin renderizarlas. Construido sobre [Discover](/es/docs/coming-soon/discover.md). | | **Extract Structured** | `POST /v2/distill` | Saca campos con nombre de una o varias páginas, o de un sitio que la API rastrea por ti. Construido sobre [Distill](/es/docs/endpoints/distill.md). | | **Convert File to Markdown** | `POST /v1/convert/anything-to-markdown` | Convierte archivos de Word, PowerPoint, Excel, PDF, EPUB, RTF, HTML y texto en markdown. Construido sobre [Anything to Markdown](/es/docs/endpoints/convert/documents/anything-to-markdown.md). | | **Convert File to PDF** | `POST /v1/convert/anything-to-pdf` | Convierte un documento, una hoja de cálculo, una presentación, una imagen, un archivo HTML o de texto en un PDF. Construido sobre [Anything to PDF](/es/docs/endpoints/convert/documents/anything-to-pdf.md). | Todo se ejecuta contra la misma API REST documentada en el resto de este sitio, así que la cuota de tu plan, los límites de frecuencia y las funciones se aplican exactamente igual que en cualquier otra parte. --- ## Instalación El plugin se instala desde su release de GitHub mientras la ficha del Marketplace está en revisión. 1. En Dify, abre **Plugins** en la esquina superior derecha. 2. Haz clic en **Install Plugin** y luego en **From GitHub**. 3. Pega la URL del repositorio: ```text https://github.com/enconvert/dify-enconvert ``` 4. Elige la versión en el desplegable. Dify descarga el asset `.difypkg` correspondiente a ese release. 5. Revisa los permisos y haz clic en **Install**. El plugin pide únicamente el permiso de herramientas y declara acceso saliente a `api.enconvert.com`, `www.enconvert.com` y al host de almacenamiento que sirve los archivos convertidos.
Dify autoalojado verifica las firmas de los plugins por defecto. Solo los paquetes del Marketplace llevan una firma que Dify reconozca, así que una instalación desde GitHub falla con plugin verification has been enabled, and the plugin you want to install has a bad signature. La solución está en Solución de problemas. Dify Cloud no se ve afectado.
--- ## Añade tu clave de API El plugin usa una sola credencial: **EnConvert API Key**. 1. Genera una clave de API **privada** en el [panel](/es/dashboard/api-keys). Las claves privadas empiezan por `sk_`. 2. Abre el plugin de EnConvert, haz clic en **To authorize** y pega la clave. 3. Guarda. Al guardar se llama a `GET /v1/whoami`, que solo acepta claves privadas, así que una clave pública `pk_` se rechaza en el momento en que la pegas en lugar de fallar más tarde dentro de la ejecución de un workflow. La clave viaja en la cabecera `X-API-Key` en cada petición que hace el plugin.
Las claves públicas no funcionan. Las claves que empiezan por pk_ están pensadas para widgets de navegador y todas las herramientas de este plugin las rechazan. Tienes más información en Claves privadas.
--- ## Leer una página **Perceive URL** toma la URL del agente y dos ajustes del formulario: | Parámetro | Quién lo fija | Predeterminado | Propósito | |-----------|--------|---------|---------| | URL | El agente | -- | La URL absoluta que se va a renderizar | | Outputs | El formulario | `markdown,structured` | Cualquiera de `markdown`, `html_cleaned`, `html_raw`, `screenshot`, `screenshot_full_page`, `pdf`, `links`, `images`, `structured`, separados por comas | | Only Main Content | El formulario | Desactivado | Elimina la navegación, los encabezados y los pies, y deja el artículo | La API devuelve cada artefacto como una URL firmada que caduca a los 15 minutos, no como texto en línea, y un agente no puede abrir una URL. Por eso el plugin lee por ti los artefactos de texto: markdown, HTML limpio y HTML crudo se descargan y se incrustan en el resultado de la herramienta, hasta 256 KB cada uno. Cualquier cosa mayor, y cualquier cosa binaria, sigue siendo un enlace. La salida `structured` es la excepción y llega en línea en el nivel superior de la respuesta. --- ## La puntuación render_quality Cada resultado de Perceive lleva `render_quality`, un número de 0.0 a 1.0. Cero significa que la página estaba bloqueada o vacía; uno significa un renderizado limpio. El contenido vuelve igualmente en ambos casos, marcado, de modo que una lectura defectuosa nunca entra en silencio en un resumen o en un almacén vectorial. Ramifica sobre ella con un nodo IF/ELSE antes del nodo LLM que consume el markdown. En un agente la puntuación va dentro del resultado de la herramienta que lee el modelo, así que una sola frase en el prompt de sistema basta para que el modelo desconfíe de una puntuación baja. --- ## Extraer campos **Extract Structured** necesita un esquema y exactamente una fuente. El esquema es un objeto JSON con una de dos formas. Un mapa plano de nombre de campo a descripción en lenguaje natural es la vía rápida: ```json {"title": "the page title", "price": "the monthly price in USD"} ``` Un JSON Schema completo, `{"type": "object", "properties": {...}}`, es la otra, y compensa escribirlo cuando necesitas que se respeten tipos u objetos anidados. Para la fuente, pasa **URLs**, una lista separada por comas y limitada a 50, o **Discover From URL**, un único sitio que la API rastrea por ti, ajustado con **Discover Mode** y **Discover Max Pages**. Pasar ambos, o ninguno, devuelve un mensaje que te lo dice. Los resultados llegan como `results[]`, una entrada por URL, cada una con sus propios datos y su propio `extraction_tier`, que indica si la respuesta la produjo una pasada determinista o un modelo leyendo la página. --- ## Convertir archivos **Convert File to Markdown** y **Convert File to PDF** toman un **file** de Dify, no una URL. Conecta un archivo desde la entrada de archivos de un nodo Start, o una variable de archivo de un nodo anterior. El plugin sube los bytes como multipart y devuelve una URL de descarga firmada para el resultado, válida durante unos 15 minutos y que se descarga con un GET normal y sin clave de API. La extensión del nombre del archivo subido decide el formato de entrada. Dify arrastra el nombre original, así que normalmente esto es invisible, pero un archivo que llega sin una extensión utilizable recurre a sus propios bytes: un PDF, una imagen o un DOCX se recupera por su firma, mientras que un formato de texto como CSV o HTML no la tiene y se rechaza con un 400. --- ## Construir con él ### Un agente que investiga Dale a un agente **Web Search**, **Perceive URL** y **Discover URLs**. La búsqueda encuentra páginas candidatas, Perceive lee como markdown las prometedoras y Discover mapea un sitio cuando el agente necesita saber qué más hay en él sin renderizar nada. ### Un workflow que convierte una subida en una respuesta ```text Start (file input) -> Convert File to Markdown -> LLM -> Answer ``` La extracción de documentos propia de Dify cubre los formatos habituales. Este camino añade los que no cubre. --- ## Solución de problemas **`plugin verification has been enabled, and the plugin you want to install has a bad signature`.** Un Dify autoalojado impone por defecto la verificación de firma en los paquetes de plugins, y solo los paquetes del Marketplace llevan una firma que reconozca. Añade `FORCE_VERIFYING_SIGNATURE=false` a `docker/.env` y reinicia: ```bash cd docker docker compose down docker compose up -d ``` Ese ajuste se aplica a todos los plugins ajenos al Marketplace de la instancia, así que trátalo como una decisión sobre la instancia y no sobre una instalación concreta. Dify Cloud no se ve afectado. **No aparece ninguna versión en el diálogo de instalación.** Dify lista un release solo cuando tiene un asset `.difypkg` adjunto. Abre el [último release](https://github.com/enconvert/dify-enconvert/releases/latest) y confirma que el asset está ahí, bajo **Assets**. Un desplegable vacío significa que no hay paquete, no que sea el equivocado. **No se guarda la credencial.** La clave es incorrecta, o es una clave pública `pk_`. Genera una clave privada en el [panel](/es/dashboard/api-keys). Al guardar se llama a `GET /v1/whoami`, que solo acepta claves privadas. **Una herramienta informa de que la operación no está en mi plan.** Perceive, Web Search, Discover y Extract Structured consumen del cupo mensual de operaciones de tu plan. Revisa tu uso en la [página de precios](/es/pricing.md). **Perceive devuelve un enlace donde esperabas markdown.** El markdown superó el límite de 256 KB para incrustarlo, así que el plugin te entregó la URL firmada en su lugar. Descárgala con un GET normal y sin clave de API. **Only Main Content** suele dejar una página larga por debajo del límite. **Una herramienta de conversión dice que esperaba un archivo subido.** Se conectó una cadena con una URL al parámetro **File**. Las dos herramientas de conversión toman un archivo de Dify. Para convertir una página web, usa **Perceive URL** con `pdf` o `markdown` en Outputs. --- ## Fuente y enlaces - **Fuente**: [enconvert/dify-enconvert](https://github.com/enconvert/dify-enconvert) - **Último release**: [releases/latest](https://github.com/enconvert/dify-enconvert/releases/latest) - **Licencia**: MIT - **Documentación de plugins de Dify**: [docs.dify.ai](https://docs.dify.ai/en/plugins/introduction) - **API subyacente**: [Introducción](/es/docs/introduction.md) --- ## Preguntas frecuentes ### ¿Cómo instalo el plugin de EnConvert en Dify? Abre **Plugins**, haz clic en **Install Plugin** y luego en **From GitHub**, y pega `https://github.com/enconvert/dify-enconvert`. Elige la versión en el desplegable, revisa los permisos y haz clic en **Install**. Dify descarga el asset `.difypkg` directamente de ese release de GitHub, que es una vía de instalación documentada y no necesita ficha en el Marketplace. ### ¿Puedo instalarlo antes de que se apruebe la ficha del Marketplace? Sí. Instalar desde un release de GitHub es una de las propias vías de publicación de Dify y cuesta más o menos los mismos clics que el Marketplace. La única diferencia es que una instancia autoalojada con la verificación de firma activada rechaza un paquete ajeno al Marketplace hasta que pones `FORCE_VERIFYING_SIGNATURE=false` en `docker/.env`. ### ¿Cómo leo una página web como markdown en un agente de Dify? Añade **Perceive URL** como herramienta y deja Outputs en su valor por defecto. El agente pasa la URL y el plugin devuelve el markdown en línea en el resultado de la herramienta, hasta 256 KB, así que el modelo lee la página y no un enlace que no puede abrir. Activa **Only Main Content** para descartar la navegación y los pies. ### ¿Por qué Perceive me da un enlace en lugar del texto? Cada artefacto que produce la API es una URL firmada de 15 minutos. El plugin descarga los de texto y los incrusta, hasta 256 KB. Una página más grande, o una salida binaria como una captura de pantalla o un PDF, sigue siendo un enlace, que se descarga con un GET normal y sin clave de API. ### ¿Cómo convierto un DOCX subido a PDF en un workflow de Dify? Añade una entrada de archivo al nodo Start y conecta esa variable de archivo a **Convert File to PDF**. La herramienta sube los bytes y devuelve una URL de descarga firmada para el PDF. La extensión del nombre del archivo decide el formato de entrada, así que conserva el nombre original.