Lavorare con un'app di IA

Se NeoDownloader non riesce a scaricare da un sito, o ne scarica le cose sbagliate, un'app di IA può insegnarglielo: studia il sito e scrive una ricetta, una breve descrizione di dove il sito tiene i propri file. NeoDownloader non ha un'IA integrata, ma la sua app può collegarsi, e nella finestra del programma si chiama agente. Si collega tramite MCP, il modo comune in cui le app di IA lavorano con altri programmi. Questa pagina descrive a che cosa serve, come collegare l'app, la schermata Agente di IA e Ripara con l'IA.

A che cosa serve

Il Crawler è il plugin che percorre le pagine di un sito e prende i file che vi trova. Lavora con le ricette: una ricetta dice dove un sito tiene i propri file e come scorrerne le pagine.

Per i siti che conosce, il Crawler ha una ricetta scritta per quel sito. Per tutti gli altri usa una di quattro ricette generali, una per ogni tipo di pagina, come una galleria o una discussione di un forum. Una ricetta del genere non sa nulla del singolo sito, quindi non sempre basta.

Se non porta nulla, o non ciò che voleva, la sua app di IA può scrivere una ricetta per quel sito. Lo stesso vale se una ricetta smette di trovare file dopo che il sito è cambiato: l'app la ripara.

Una ricetta si crea una volta sola. Da quel momento si occupa del suo sito in ogni progetto, e le esecuzioni non hanno bisogno dell'app. L'app non scarica nulla da sé: la sua esecuzione di prova si limita a elencare i file, e a scaricare è un progetto avviato da lei. L'app lavora con il suo abbonamento, o con un modello gratuito se ne ha uno.

Provi prima un progetto normale, perché i tipi di pagina del Crawler spesso se la cavano, in secondi dove un'app impiega minuti. Se preferisce aspettare noi invece di creare una ricetta, usi Chiederci una ricetta per questo sito.

Solo il Crawler legge le ricette. Video Downloader, Gallery Downloader e Collegamenti diretti no.

Che cosa l'app può vedere e fare

L'app lavora in modo visibile: ogni passo è una riga nel diario descritto più sotto. Che cosa riceve, che cosa non può fare e dove possono finire le sue risposte è spiegato in Un'app di IA che lei collega. Lo legga prima di collegare un'app, soprattutto se ha effettuato l'accesso a dei siti nel browser di NeoDownloader.

Se lavora con un modello gratuito in OpenCode, lo guardi prima di usarlo. L'elenco di OpenCode dice che cosa fa ogni modello gratuito con i suoi dati. Mentre scriviamo, DeepSeek V4.1 Flash Free e GLM-5.3-Flash Free non conservano nulla e non li usano per l'addestramento, mentre altri possono conservarli 30 giorni o usarli per migliorare il modello.

Collegare la sua app

Non ha ancora un'app di IA? Inizi da qui.

Lo fa una volta sola, sul computer in cui è in esecuzione NeoDownloader.

1. Faccia clic su Agente di IA nella barra laterale a sinistra.
2. Faccia clic su Come collegarlo, sotto la prima riga della schermata.
3. Nella finestra Crea una ricetta con l'IA, sotto Colleghi la sua app di IA, scelga la sua app dall'elenco.
4. Per Claude Desktop, ChatGPT / Codex e OpenCode, faccia clic su Aggiungi a Claude Desktop, Aggiungi a ChatGPT / Codex o Aggiungi a OpenCode: NeoDownloader scrive da solo la voce nel file di impostazioni dell'app. Per qualsiasi altra app, faccia ciò che dice la finestra. Copia prende il testo, che contiene già i percorsi del suo computer.
5. Riavvii la sua app di IA. NeoDownloader invece non ha bisogno di essere riavviato.

Il pulsante non cambia nient'altro nel file e lascia il vecchio file accanto, con .before-neodownloader in fondo al nome. Se non riesce a leggere il file, non lo tocca e apre il testo sotto Aggiungi a mano. Questo collegamento funziona anche da solo.

NeoDownloader deve essere in esecuzione mentre l'app lavora. Se è chiuso, l'app lo viene a sapere e dovrebbe chiederle di avviarlo.

Dove va il testo

La finestra mostra il testo pronto da incollare. Qui sotto trova dove va in ogni app e che aspetto ha. In questi esempi PROGRAM indica il percorso di NeoDownloader sul suo computer e FOLDER la sua cartella dei dati, quindi copi il testo dalla finestra.

Se il file di impostazioni elenca già altri server, metta la voce neodownloader accanto a loro, nello stesso elenco. Il testo non contiene password né chiavi: la connessione legge ciò che le serve dalla cartella dei dati di 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

Chiedere una ricetta

Scriva alla sua app nella casella del messaggio, per esempio: «Crea una ricetta di NeoDownloader per example.com.» Vanno bene anche parole sue, o la frase che prepara NeoDownloader.

La stessa finestra si apre da tre punti:

• Crea una ricetta con l'IA in cima alla scheda Ricette, quando un'app si è collegata. La frase lì ha uno spazio vuoto per il sito: ci metta l'indirizzo.
• Crea una ricetta per questo sito con l'IA nella procedura guidata Nuovo progetto, sotto Da dove vengono i file?
• Ripara con l'IA su un progetto; veda più sotto.

Quando un'app si è collegata, i passaggi qui sopra si riducono a una riga come Claude Desktop ha chiamato NeoDownloader l'ultima volta il …, e Come collegarne un'altra li riapre. Sotto Lo dica al suo agente c'è la frase, nella lingua della finestra di NeoDownloader. Copia la prende. La incolli nella sua app.

La finestra aperta dalla procedura guidata termina con Quando il suo agente salverà la ricetta, la procedura guidata la userà da sola. Lasci aperta la procedura guidata. Quando la ricetta è salvata, la procedura guidata interpella di nuovo i plugin e riporta Il suo agente ha salvato una ricetta e la procedura guidata ha controllato di nuovo l'indirizzo.

Quando l'app dice che la ricetta è salvata, crei un progetto normale con l'indirizzo del sito: ora il Crawler usa quella ricetta e il progetto scarica i file. La ricetta compare anche nella scheda Ricette.

La schermata Agente di IA

Agente di IA è nella barra laterale a sinistra, in ogni schermata, e la finestra chiama agente la sua app collegata. Un punto sulla voce significa che lì c'è qualcosa di nuovo. NeoDownloader non la porta mai lì di sua iniziativa.

In cima alla colonna di sinistra c'è ciò che sta facendo l'app, con sotto il suo nome, per esempio tramite Claude Desktop 1.2:

Il diario

Sotto quella riga c'è il diario: una riga per ogni passo dell'app, la più recente in fondo, nella lingua della finestra di NeoDownloader. L'ora compare al primo passo di ogni minuto. Quando il nome dell'app cambia, un'intestazione nomina l'app successiva.

• Un passo non riuscito ha un contrassegno sulla sua riga; passi il puntatore sul contrassegno per il motivo: Rifiutato, Fermato, Troppo tempo o Non riuscito.
• Fuori dal sito della bozza contrassegna un passo che ha lasciato il sito a cui è destinata la ricetta.
• Faccia clic su un passo che ha aperto una pagina per rivedere quella pagina.
• Se scorre verso l'alto, il diario resta dove si trova lei, e Nuove: 3 la porta agli ultimi passi.
• Svuota vuota il diario subito, senza chiedere. Ricette e bozze restano.

L'app può avere bisogno di lei per un accesso o un controllo su un sito. La sua richiesta compare nel diario sotto L'agente le chiede, con Mostra la pagina. Faccia sulla pagina ciò che chiede, poi lo dica all'app.

La pagina e le ricette

A destra del diario ci sono due schede. Pagina c'è finché l'app ha una pagina aperta, e la mostra nel browser di NeoDownloader. Ricette elenca le sue ricette. Una nuova pagina dell'app occupa il pannello solo se lei non ha scelto Ricette: una scheda che ha scelto resta. Un punto su una scheda significa che lì è arrivato qualcosa di nuovo.

In una finestra stretta c'è una sola colonna, con Diario, Pagina e Ricette come schede.

Ricette

La scheda Ricette elenca le sue ricette personali: quelle salvate dalla sua app di IA e quelle eventualmente salvate dall'editor delle ricette di una versione precedente. Le ricette del catalogo qui non compaiono. Una sua ricetta si occupa dei propri siti in ogni progetto, prima di quella del catalogo.

Il riquadro di una ricetta riporta il nome, i siti e quando è stata salvata, e può avere questi contrassegni:

• Creata dall'IA - l'ha salvata la sua app di IA.
• Con codice - ha accanto del codice proprio.
• Illeggibile - NeoDownloader la salta finché non viene riparata; il riquadro mostra che cosa non va.

Usata al posto della ricetta del catalogo: … dice quale ricetta viene sostituita.

Elimina chiede prima conferma, e dice chi si occuperà di quei siti in seguito: una ricetta del catalogo oppure i tipi di pagina generali del Crawler. Una copia resta accanto alle sue ricette, nella cartella .prev. Solo lei può eliminare una ricetta: l'app non può.

Consenti MCP

Consenti MCP, sotto la prima riga della schermata, è il permesso dell'app. Se è disattivato, NeoDownloader smette di rispondere alle app di IA tramite MCP, qualunque cosa chieda l'app, e ciò che l'app aveva avviato si ferma, compresa la sua pagina aperta. La schermata riporta MCP è disattivato: ogni chiamata di un'app di IA viene rifiutata finché non consente di nuovo MCP.

Resta disattivato anche dopo un riavvio, finché non lo attiva. Per impedire definitivamente all'app di lavorare con NeoDownloader, rimuova anche NeoDownloader dalle impostazioni dell'app stessa.

Ripara con l'IA

Un riquadro con Ripara con l'IA si trova nella scheda Proprietà di un progetto aperto, tra le proprietà del progetto ed Elimina il progetto. Apre la finestra Crea una ricetta con l'IA, con i passaggi per collegare un'app se nessuna si è ancora collegata. Che cosa chiede la frase dipende dal plugin del progetto.

In un progetto del Crawler, la frase nomina il sito, l'indirizzo e il numero di file portati dall'ultima esecuzione, e chiede all'app di scoprire perché la ricetta ha smesso di funzionare e di ripararla.

In un progetto di un altro plugin non c'è una ricetta da riparare, quindi all'app viene chiesto di crearne una nuova per l'indirizzo. Il riquadro lo dice: Le ricette servono a Crawler, e questo progetto scarica con un altro plugin. Chieda al suo agente IA di creare una ricetta per questo sito, poi crei un nuovo progetto per questo indirizzo con Crawler. Il progetto da cui è partito resta com'era.

Anche un progetto il cui plugin non c'è più ha Ripara con l'IA, nell'avviso in cima alla scheda, e anche lì viene chiesta una nuova ricetta.