Temas de ayuda
Todos los temas de ayuda

Trabajar con una aplicación de IA

Si NeoDownloader no puede descargar de un sitio, o descarga de él lo que no debe, una aplicación de IA puede enseñárselo: estudia el sitio y escribe una receta, una breve descripción de dónde guarda el sitio sus archivos. NeoDownloader no incluye IA, pero su aplicación puede conectarse a él, y en la ventana del programa se llama agente. Se conecta por MCP, la forma habitual en que las aplicaciones de IA trabajan con otros programas. Esta página trata de para qué sirve eso, de cómo conectar la aplicación, de la pantalla Agente de IA y de Reparar con IA.

Para qué sirve

El Crawler es el plugin que recorre las páginas de un sitio y toma los archivos que encuentra en ellas. Trabaja con recetas: una receta indica dónde guarda un sitio sus archivos y cómo recorrerlos página a página.

Para los sitios que conoce, el Crawler tiene una receta escrita para ese sitio. Para cualquier otro usa una de cuatro recetas generales, una por cada tipo de página, como una galería o un hilo de foro. Esa receta no sabe nada del sitio concreto, así que no siempre funciona.

Si no trae nada, o no lo que usted quería, su aplicación de IA puede escribir una receta para ese sitio. Lo mismo ocurre si una receta deja de encontrar archivos después de que el sitio cambie: la aplicación la repara.

Una receta se crea una sola vez. A partir de ahí se encarga de su sitio en todos los proyectos, y las ejecuciones no necesitan la aplicación. La aplicación no descarga nada por sí misma: su ejecución de prueba solo enumera los archivos, y la descarga la hace un proyecto que usted inicie. La aplicación funciona con su suscripción, o con un modelo gratuito si lo tiene.

Pruebe primero con un proyecto normal, porque los tipos de página del Crawler suelen bastar, en segundos donde una aplicación tarda minutos. Si prefiere esperar a que la hagamos nosotros antes que crear una receta, use Pídanos una receta para este sitio.

Solo el Crawler lee recetas. Video Downloader, Gallery Downloader y Enlaces directos no las leen.

Qué puede ver y hacer la aplicación

La aplicación trabaja a la vista: cada paso es una línea del registro que se describe más abajo. Lo que recibe, lo que no puede hacer y adónde pueden ir sus respuestas está en Una aplicación de IA que usted conecta. Léalo antes de conectar una aplicación, sobre todo si tiene sesión iniciada en sitios en el navegador de NeoDownloader.

Si trabaja con un modelo gratuito en OpenCode, mírelo antes de usarlo. La lista de OpenCode indica qué hace cada modelo gratuito con sus datos. En el momento de escribir esto, DeepSeek V4.1 Flash Free y GLM-5.3-Flash Free no guardan nada ni entrenan con ellos, mientras que otros pueden conservarlos 30 días o usarlos para mejorar el modelo.

Conectar su aplicación

¿Aún sin aplicación de IA? Empiece aquí.

Esto se hace una sola vez, en el equipo en el que se ejecuta NeoDownloader.

  1. Haga clic en Agente de IA en la barra de la izquierda.
  2. Haga clic en Cómo conectarlo, bajo la primera línea de la pantalla.
  3. En la ventana Crear una receta con IA, bajo Conectar su aplicación de IA, elija su aplicación en la lista.
  4. Para Claude Desktop, ChatGPT / Codex y OpenCode, haga clic en Añadir a Claude Desktop, Añadir a ChatGPT / Codex o Añadir a OpenCode: NeoDownloader escribe la entrada en el archivo de ajustes de la aplicación. Para cualquier otra aplicación, haga lo que indica la ventana. Copiar toma el texto, que ya lleva las rutas de su equipo.
  5. Reinicie su aplicación de IA. NeoDownloader no necesita reiniciarse.

El botón no cambia nada más en el archivo y deja el archivo anterior al lado, con .before-neodownloader al final del nombre. Si no puede leer el archivo, no lo toca y abre el texto bajo Añadir a mano. Ese enlace también funciona por sí solo.

NeoDownloader tiene que estar en marcha mientras la aplicación trabaja. Si está cerrado, la aplicación recibe ese aviso y debería pedirle que lo inicie.

Dónde va el texto

La ventana muestra el texto listo para pegar. Abajo se indica dónde va en cada aplicación y qué aspecto tiene. En estas muestras, PROGRAM representa la ruta de NeoDownloader en su equipo y FOLDER su carpeta de datos, así que copie el texto de la ventana.

Si el archivo de ajustes ya enumera otros servidores, ponga la entrada neodownloader junto a ellos, en la misma lista. El texto no contiene ninguna contraseña ni clave: la conexión lee lo que necesita de la carpeta de datos de NeoDownloader.

Claude Desktop

Añada esto al archivo de su sistema:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Claude Code

Ejecute esto en un terminal:

claude mcp add --scope user neodownloader -- PROGRAM --mcp --install-dir FOLDER
ChatGPT / Codex

Añada esto a ~/.codex/config.toml, en Windows a %USERPROFILE%\.codex\config.toml:

[mcp_servers.neodownloader]
command = "PROGRAM"
args = ["--mcp", "--install-dir", "FOLDER"]

La aplicación de escritorio de ChatGPT y Codex leen este archivo. ChatGPT en el navegador no puede conectarse, así que instale la aplicación de escritorio.

Cursor

Añada esto a ~/.cursor/mcp.json, en Windows a %USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
VS Code

Abra Command Palette > MCP: Open User Configuration y añada esto:

{
  "servers": {
    "neodownloader": {
      "type": "stdio",
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
GitHub Copilot CLI

Añada esto a ~/.copilot/mcp-config.json, en Windows a %USERPROFILE%\.copilot\mcp-config.json:

{
  "mcpServers": {
    "neodownloader": {
      "type": "local",
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"],
      "tools": ["*"]
    }
  }
}
OpenCode

Añada esto a ~/.config/opencode/opencode.json, en Windows a %USERPROFILE%\.config\opencode\opencode.json:

{
  "mcp": {
    "neodownloader": {
      "type": "local",
      "command": ["PROGRAM", "--mcp", "--install-dir", "FOLDER"],
      "enabled": true
    }
  }
}
Antigravity

Añada esto a ~/.gemini/config/mcp_config.json, en Windows a %USERPROFILE%\.gemini\config\mcp_config.json:

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Windsurf

Abra Cascade > MCP > Open MCP config file y añada esto:

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
JetBrains AI Assistant

Abra Settings | Tools | AI Assistant | Model Context Protocol (MCP) | Add y añada esto:

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Zed

Abra Command Palette > zed: open settings file y añada esto:

{
  "context_servers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Cline

Abra MCP Servers > Configure > Configure MCP Servers y añada esto:

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Roo Code

Abra MCP > Edit Global MCP y añada esto:

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Kiro

Añada esto a ~/.kiro/settings/mcp.json, en Windows a %USERPROFILE%\.kiro\settings\mcp.json:

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
LM Studio

Abra Program > Install > Edit mcp.json y añada esto:

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Otra

Para cualquier otra aplicación que se conecte por MCP y pueda iniciar programas en su equipo, la ventana da el comando y sus argumentos:

command: PROGRAM
args: --mcp --install-dir FOLDER

Muchas aplicaciones aceptan el mismo texto que Cursor. Una aplicación que solo llega a servidores de internet no puede conectarse, porque esta conexión se queda en su equipo.

Pedir una receta

Escriba a su aplicación en el cuadro de mensaje, por ejemplo: «Crea una receta de NeoDownloader para example.com.» También sirven sus propias palabras o la frase que prepara NeoDownloader.

La misma ventana se abre desde tres lugares:

  • Crear una receta con IA, en la parte superior de la pestaña Recetas, una vez que se haya conectado una aplicación. La frase de ahí tiene un hueco para el sitio: ponga la dirección en su lugar.
  • Crear una receta para este sitio con IA, en el asistente Proyecto nuevo, bajo ¿De dónde vienen los archivos?
  • Reparar con IA, en un proyecto; consulte más abajo.

Una vez que se ha conectado una aplicación, los pasos anteriores se pliegan en una línea como Claude Desktop llamó a NeoDownloader por última vez el …, y Cómo conectar otra los vuelve a abrir. Bajo Dígaselo a su agente está la frase, en el idioma de la ventana de NeoDownloader. Copiar la toma. Péguela en su aplicación.

La ventana abierta desde el asistente termina con Cuando su agente guarde la receta, el asistente la recogerá solo. Deje el asistente abierto. Cuando se guarde la receta, el asistente vuelve a consultar a los plugins e indica Su agente guardó una receta y el asistente volvió a comprobar la dirección.

Cuando la aplicación diga que la receta está guardada, cree un proyecto normal con la dirección del sitio: ahora el Crawler usa esa receta y el proyecto descarga los archivos. La receta también aparece en la pestaña Recetas.

La pantalla Agente de IA

Agente de IA está en la barra de la izquierda, en todas las pantallas, y la ventana llama agente a la aplicación que ha conectado. Un punto en el elemento significa que hay algo nuevo. NeoDownloader nunca le lleva allí por sí solo.

En la parte superior de la columna izquierda está lo que hace la aplicación, con su nombre debajo, como a través de Claude Desktop 1.2:

La línea indica Qué significa
El agente de IA aún no está conectado Ninguna aplicación ha llamado todavía a este NeoDownloader.
El agente de IA está trabajando La aplicación ha llamado en el último minuto.
El agente de IA está inactivo Hay una aplicación conectada, y ahora está en silencio.
El agente de IA está detenido Permitir MCP está desactivado.
El agente le pregunta La aplicación le está esperando.

El registro

Debajo de esa línea está el registro: una línea por cada paso que da la aplicación, con la más reciente abajo, en el idioma de la ventana de NeoDownloader. La hora aparece en el primer paso de cada minuto. Cuando cambia el nombre de la aplicación, un encabezado indica la siguiente aplicación.

  • Un paso que falló lleva una marca en su línea; pase el puntero por encima de la marca para ver el motivo: Rechazado, Detenido, Tardó demasiado o Falló.
  • Fuera del sitio del borrador marca un paso que salió del sitio para el que es la receta.
  • Haga clic en un paso que abrió una página para volver a verla.
  • Si se desplaza hacia arriba, el registro se queda donde está, y Nuevas: 3 le lleva a los últimos pasos.
  • Vaciar deja vacío el registro enseguida, sin preguntar. Las recetas y los borradores se quedan.

La aplicación puede necesitarle para iniciar sesión o pasar una comprobación en un sitio. Su petición aparece en el registro bajo El agente le pregunta, con Mostrar la página. Haga en la página lo que le pide y luego dígaselo a la aplicación.

La página y las recetas

A la derecha del registro hay dos pestañas. Página está ahí mientras la aplicación tiene una página abierta, y la muestra en el navegador de NeoDownloader. Recetas enumera sus recetas. La nueva página de la aplicación ocupa el panel solo si usted no ha elegido Recetas: la pestaña que eligió se queda. Un punto en una pestaña significa que allí ha llegado algo nuevo.

En una ventana estrecha hay una sola columna, con Registro, Página y Recetas como pestañas.

Recetas

La pestaña Recetas enumera sus propias recetas: las que guardó su aplicación de IA y las que haya guardado el editor de recetas de una versión anterior. Las recetas del catálogo no aparecen aquí. Su propia receta se encarga de sus sitios en todos los proyectos, por delante de la del catálogo.

La tarjeta de una receta tiene su nombre, sus sitios y cuándo se guardó, y puede llevar estas marcas:

  • Creada por IA - la guardó su aplicación de IA.
  • Con código - tiene código propio a su lado.
  • No se puede leer - NeoDownloader la omite hasta que se repare; la tarjeta muestra qué falla.

Se usa en lugar de la receta del catálogo: … indica a qué sustituye la receta.

Eliminar pregunta primero e indica qué se encargará de esos sitios después: una receta del catálogo o los tipos de página generales del Crawler. Se guarda una copia junto a sus recetas, en la carpeta .prev. Solo usted puede eliminar una receta: la aplicación no puede.

Permitir MCP

Permitir MCP, bajo la primera línea de la pantalla, es el permiso de la aplicación. Si se desactiva, NeoDownloader deja de responder a las aplicaciones de IA por MCP, pida lo que pida la aplicación, y se detiene lo que la aplicación había iniciado, incluida su página abierta. La pantalla indica MCP está desactivado: cada llamada de una aplicación de IA se rechaza hasta que vuelva a permitir MCP.

Sigue desactivado después de un reinicio, hasta que usted lo active. Para impedir de forma definitiva que la aplicación trabaje con NeoDownloader, quite también NeoDownloader de los ajustes de la propia aplicación.

Reparar con IA

Una tarjeta con Reparar con IA aparece en la pestaña Propiedades de un proyecto abierto, entre las propiedades del proyecto y Eliminar el proyecto. Abre la ventana Crear una receta con IA, con los pasos para conectar una aplicación si aún no se ha conectado ninguna. Lo que pide la frase depende del plugin del proyecto.

En un proyecto del Crawler, la frase nombra el sitio, la dirección y el número de archivos que trajo la última ejecución, y pide a la aplicación que averigüe por qué dejó de funcionar la receta y que la repare.

En un proyecto de otro plugin no hay receta que reparar, así que se pide a la aplicación que cree una nueva para la dirección. La tarjeta lo dice: Las recetas son para Crawler, y este proyecto descarga con otro plugin. Pida a su agente de IA que cree una receta para este sitio y luego cree un proyecto nuevo para esta dirección con Crawler. El proyecto del que partió se queda como estaba.

Un proyecto cuyo plugin ya no está también tiene Reparar con IA, en el aviso de la parte superior de la pestaña, y también pide una receta nueva.