Travailler avec une application d'IA

Si NeoDownloader ne peut pas télécharger depuis un site, ou n'en télécharge pas ce qu'il faut, une application d'IA peut le lui apprendre : elle étudie le site et écrit une recette, une courte description de l'endroit où le site range ses fichiers. NeoDownloader n'intègre pas d'IA, mais votre application peut s'y connecter, et la fenêtre du programme l'appelle l'agent. Elle se connecte via MCP, le moyen courant pour les applications d'IA de travailler avec d'autres programmes. Cette page présente à quoi cela sert, la connexion de l'application, l'écran Agent IA et Réparer avec l'IA.

À quoi cela sert

Le Crawler est le plugin qui parcourt les pages d'un site et prend les fichiers qu'il y trouve. Il travaille avec des recettes : une recette indique où un site range ses fichiers et comment passer d'une page à l'autre.

Pour les sites qu'il connaît, le Crawler a une recette écrite pour ce site. Pour tous les autres, il utilise l'une de quatre recettes générales, une par type de page, comme une galerie ou un fil de forum. Une telle recette ne sait rien du site en question, et elle ne suffit donc pas toujours.

Si elle ne rapporte rien, ou pas ce que vous vouliez, votre application d'IA peut écrire une recette pour ce site. Il en va de même si une recette cesse de trouver des fichiers après un changement du site : l'application la répare.

Une recette se crée une seule fois. Ensuite, elle prend son site en charge dans tous les projets, et les exécutions n'ont pas besoin de l'application. L'application ne télécharge rien elle-même : son exécution d'essai ne fait que lister les fichiers, et c'est un projet que vous démarrez qui télécharge. L'application fonctionne avec votre abonnement, ou avec un modèle gratuit si elle en a un.

Essayez d'abord un projet ordinaire, car les types de page du Crawler s'en sortent souvent, en quelques secondes là où une application met plusieurs minutes. Si vous préférez attendre que nous le fassions plutôt que de créer une recette, utilisez Nous demander une recette pour ce site.

Seul le Crawler lit les recettes. Video Downloader, Gallery Downloader et Liens directs ne les lisent pas.

Ce que l'application peut voir et faire

L'application travaille à découvert : chaque étape est une ligne du journal décrit plus bas. Ce qu'elle reçoit, ce qu'elle ne peut pas faire et où ses réponses peuvent aller sont décrits dans Une application d'IA que vous connectez. Lisez cela avant de connecter une application, surtout si vous êtes connecté à des sites dans le navigateur de NeoDownloader.

Si vous travaillez avec un modèle gratuit dans OpenCode, regardez-le avant de l'utiliser. La liste d'OpenCode indique ce que chaque modèle gratuit fait de vos données. Au moment où nous écrivons, DeepSeek V4.1 Flash Free et GLM-5.3-Flash Free ne conservent rien et ne s'entraînent pas dessus, tandis que d'autres peuvent les garder 30 jours ou s'en servir pour améliorer le modèle.

Connecter votre application

Pas encore d'application d'IA ? Commencez ici.

Cela se fait une seule fois, sur l'ordinateur où NeoDownloader tourne.

1. Cliquez sur Agent IA dans la barre de gauche.
2. Cliquez sur Comment le connecter, sous la première ligne de l'écran.
3. Dans la fenêtre Créer une recette avec l'IA, sous Connecter votre application d'IA, choisissez votre application dans la liste.
4. Pour Claude Desktop, ChatGPT / Codex et OpenCode, cliquez sur Ajouter à Claude Desktop, Ajouter à ChatGPT / Codex ou Ajouter à OpenCode : NeoDownloader écrit lui-même l'entrée dans le fichier de paramètres de l'application. Pour toute autre application, faites ce qu'indique la fenêtre. Copier prend le texte, qui contient déjà les chemins de votre ordinateur.
5. Redémarrez votre application d'IA. NeoDownloader lui-même n'a pas besoin de redémarrer.

Le bouton ne change rien d'autre dans le fichier et laisse l'ancien fichier à côté, avec .before-neodownloader à la fin de son nom. S'il ne peut pas lire le fichier, il n'y touche pas et ouvre le texte sous Ajouter à la main. Ce lien fonctionne aussi tout seul.

NeoDownloader doit être en marche pendant que l'application travaille. S'il est fermé, l'application en est informée et devrait vous demander de le démarrer.

Où va le texte

La fenêtre montre le texte prêt à coller. Ci-dessous figurent l'endroit où il va dans chaque application et son aspect. Dans ces exemples, PROGRAM représente le chemin de NeoDownloader sur votre ordinateur et FOLDER son dossier de données : copiez donc le texte depuis la fenêtre.

Si le fichier de paramètres contient déjà d'autres serveurs, placez l'entrée neodownloader à côté d'eux, dans la même liste. Le texte ne contient ni mot de passe ni clé : la connexion lit ce dont elle a besoin dans le dossier de données de NeoDownloader.

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

claude mcp add --scope user neodownloader -- PROGRAM --mcp --install-dir FOLDER

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Demander une recette

Écrivez à votre application dans la zone de message, par exemple : « Crée une recette NeoDownloader pour example.com. » Vos propres mots conviennent aussi, tout comme la phrase que NeoDownloader prépare.

La même fenêtre s'ouvre depuis trois endroits :

• Créer une recette avec l'IA en haut de l'onglet Recettes, une fois qu'une application s'est connectée. La phrase y comporte un blanc pour le site : mettez l'adresse à sa place.
• Créer une recette pour ce site avec l'IA dans l'assistant Nouveau projet, sous D'où viennent les fichiers ?
• Réparer avec l'IA sur un projet ; voir plus bas.

Une fois qu'une application s'est connectée, les étapes ci-dessus se replient en une ligne comme Claude Desktop a appelé NeoDownloader pour la dernière fois le …, et Comment en connecter une autre les rouvre. Sous Dites-le à votre agent se trouve la phrase, dans la langue de la fenêtre de NeoDownloader. Copier la prend. Collez-la dans votre application.

La fenêtre ouverte depuis l'assistant se termine par Quand votre agent enregistrera la recette, l'assistant la prendra en compte de lui-même. Laissez l'assistant ouvert. Quand la recette est enregistrée, l'assistant interroge de nouveau les plugins et indique Votre agent a enregistré une recette, et l'assistant a vérifié l'adresse à nouveau.

Quand l'application dit que la recette est enregistrée, créez un projet ordinaire avec l'adresse du site : le Crawler utilise maintenant cette recette, et le projet télécharge les fichiers. La recette apparaît aussi dans l'onglet Recettes.

L'écran Agent IA

Agent IA se trouve dans la barre de gauche, sur tous les écrans, et la fenêtre appelle « agent » votre application connectée. Un point sur cet élément signale du nouveau. NeoDownloader ne vous y amène jamais de lui-même.

En haut de la colonne de gauche figure ce que fait l'application, avec son nom en dessous, comme via Claude Desktop 1.2 :

Le journal

Sous cette ligne se trouve le journal : une ligne pour chaque étape de l'application, la plus récente en bas, dans la langue de la fenêtre de NeoDownloader. L'heure figure à la première étape de chaque minute. Quand le nom de l'application change, un titre nomme l'application suivante.

• Une étape qui a échoué porte une marque sur sa ligne ; survolez la marque pour voir la raison : Refusé, Arrêté, Trop long ou Échec.
• Hors du site du brouillon signale une étape qui a quitté le site auquel la recette est destinée.
• Cliquez sur une étape qui a ouvert une page pour revoir cette page.
• Si vous faites défiler vers le haut, le journal reste où vous êtes, et Nouvelles : 3 vous mène aux dernières étapes.
• Vider vide le journal aussitôt, sans rien demander. Les recettes et les brouillons restent.

L'application peut avoir besoin de vous pour une connexion ou une vérification sur un site. Sa demande figure dans le journal sous L'agent vous demande, avec Afficher la page. Faites ce qu'elle demande sur la page, puis dites-le à l'application.

La page et les recettes

À droite du journal se trouvent deux onglets. Page est présent tant que l'application a une page ouverte, et la montre dans le navigateur de NeoDownloader. Recettes liste vos recettes. La nouvelle page de l'application ne prend le panneau que si vous n'avez pas choisi Recettes : un onglet que vous avez choisi reste affiché. Un point sur un onglet signale du nouveau.

Dans une fenêtre étroite, il n'y a qu'une colonne, avec Journal, Page et Recettes comme onglets.

Recettes

L'onglet Recettes liste vos propres recettes : celles que votre application d'IA a enregistrées, et celles qu'a pu enregistrer l'éditeur de recettes d'une version antérieure. Les recettes du catalogue n'y figurent pas. Votre propre recette prend en charge ses sites dans tous les projets, avant celle du catalogue.

La carte d'une recette indique son nom, ses sites et la date de son enregistrement, et elle peut porter ces marques :

• Créée par l'IA - votre application d'IA l'a enregistrée.
• Avec du code - elle a son propre code à côté d'elle.
• Illisible - NeoDownloader l'ignore jusqu'à ce qu'elle soit corrigée ; la carte indique ce qui ne va pas.

Utilisée à la place de la recette du catalogue : … indique ce que la recette remplace.

Supprimer demande d'abord confirmation et indique ce qui prendra ces sites en charge ensuite : une recette du catalogue ou les types de page généraux du Crawler. Une copie est conservée à côté de vos recettes, dans le dossier .prev. Vous seul pouvez supprimer une recette : l'application ne le peut pas.

Autoriser MCP

Autoriser MCP, sous la première ligne de l'écran, est l'autorisation de l'application. Quand il est désactivé, NeoDownloader cesse de répondre aux applications d'IA via MCP, quoi que l'application demande, et ce que l'application avait lancé s'arrête, y compris sa page ouverte. L'écran indique MCP est désactivé : chaque appel d'une application d'IA est refusé jusqu'à ce que vous autorisiez de nouveau MCP.

Il reste désactivé après un redémarrage, jusqu'à ce que vous l'activiez. Pour empêcher définitivement l'application de travailler avec NeoDownloader, supprimez aussi NeoDownloader des paramètres de l'application elle-même.

Réparer avec l'IA

Une carte avec Réparer avec l'IA se trouve dans l'onglet Propriétés d'un projet ouvert, entre les propriétés du projet et Supprimer le projet. Elle ouvre la fenêtre Créer une recette avec l'IA, avec les étapes pour connecter une application si aucune ne s'est encore connectée. Ce que demande la phrase dépend du plugin du projet.

Sur un projet du Crawler, la phrase nomme le site, l'adresse et le nombre de fichiers rapportés par la dernière exécution, et demande à l'application de trouver pourquoi la recette a cessé de fonctionner et de la réparer.

Sur un projet d'un autre plugin, il n'y a pas de recette à réparer : l'application est donc priée d'en créer une nouvelle pour l'adresse. La carte le dit : Les recettes servent à Crawler, et ce projet télécharge avec un autre plugin. Demandez à votre agent IA de créer une recette pour ce site, puis créez un nouveau projet pour cette adresse avec Crawler. Le projet dont vous êtes parti reste tel quel.

Un projet dont le plugin a disparu a lui aussi Réparer avec l'IA, dans l'avertissement en haut de l'onglet, et il demande également une nouvelle recette.