Trabalhar com um aplicativo de IA

Se o NeoDownloader não consegue baixar de um site, ou baixa dele a coisa errada, um aplicativo de IA pode ensiná-lo: ele estuda o site e escreve uma receita, uma descrição curta de onde o site guarda seus arquivos. O NeoDownloader não tem IA integrada, mas o seu aplicativo pode se conectar a ele, e na janela do programa ele se chama agente. Ele se conecta por MCP, o modo comum de os aplicativos de IA trabalharem com outros programas. Esta página explica para que isso serve, como conectar o aplicativo, a tela Agente de IA e Corrigir com IA.

Para que serve

O Crawler é o plugin que percorre as páginas de um site e pega os arquivos que encontra nelas. Ele trabalha com receitas: uma receita diz onde um site guarda seus arquivos e como percorrê-los página por página.

Para os sites que ele conhece, o Crawler tem uma receita escrita para aquele site. Para qualquer outro, ele usa uma de quatro receitas gerais, uma para cada tipo de página, como uma galeria ou um tópico de fórum. Essa receita não sabe nada sobre o site em questão, então nem sempre basta.

Se ela não trouxer nada, ou não trouxer o que você queria, o seu aplicativo de IA pode escrever uma receita para aquele site. O mesmo vale quando uma receita para de encontrar arquivos depois que o site muda: o aplicativo a conserta.

Uma receita é feita uma vez. Daí em diante, ela cuida do site dela em todos os projetos, e as execuções não precisam do aplicativo. O próprio aplicativo não baixa nada: a execução de teste dele só lista os arquivos, e quem baixa é um projeto que você inicia. O aplicativo funciona com a sua assinatura, ou com um modelo gratuito, se tiver um.

Experimente primeiro um projeto comum, porque os tipos de página do Crawler muitas vezes resolvem em segundos o que um aplicativo levaria minutos para fazer. Se você preferir esperar por nós a fazer uma receita, use Peça-nos uma receita para este site.

Só o Crawler lê receitas. Os plugins Video Downloader, Gallery Downloader e Links diretos não leem.

O que o aplicativo pode ver e fazer

O aplicativo trabalha às claras: cada passo é uma linha no diário descrito abaixo. O que ele recebe, o que não pode fazer e para onde as respostas dele podem ir está em Um aplicativo de IA que você conecta. Leia isso antes de conectar um aplicativo, principalmente se você tiver entrado em sites no navegador do NeoDownloader.

Se você trabalha com um modelo gratuito no OpenCode, olhe o modelo antes de usar. A lista do OpenCode diz o que cada modelo gratuito faz com seus dados. No momento em que escrevemos, o DeepSeek V4.1 Flash Free e o GLM-5.3-Flash Free não guardam nada e não treinam com eles, enquanto outros podem guardá-los por 30 dias ou usá-los para melhorar o modelo.

Conectar o seu aplicativo

Ainda não tem um aplicativo de IA? Comece aqui.

Você faz isso uma vez, no computador em que o NeoDownloader roda.

1. Clique em Agente de IA na barra à esquerda.
2. Clique em Como conectar, abaixo da primeira linha da tela.
3. Na janela Criar uma receita com IA, em Conectar seu aplicativo de IA, escolha o seu aplicativo na lista.
4. Para o Claude Desktop, o ChatGPT / Codex e o OpenCode, clique em Adicionar ao Claude Desktop, Adicionar ao ChatGPT / Codex ou Adicionar ao OpenCode: o NeoDownloader grava a entrada no arquivo de configurações do aplicativo. Para qualquer outro aplicativo, faça o que a janela diz. Copiar copia o texto, que já traz os caminhos do seu computador.
5. Reinicie o seu aplicativo de IA. O próprio NeoDownloader não precisa ser reiniciado.

O botão não muda mais nada no arquivo e deixa o arquivo antigo ao lado, com .before-neodownloader no fim do nome. Se não conseguir ler o arquivo, ele não o toca e abre o texto em Adicionar à mão. Esse link também funciona sozinho.

O NeoDownloader precisa estar aberto enquanto o aplicativo trabalha. Se ele estiver fechado, o aplicativo fica sabendo disso e deve pedir que você o inicie.

Onde vai o texto

A janela mostra o texto pronto para colar. Abaixo está onde ele vai em cada aplicativo e como ele é. Nestes exemplos, PROGRAM representa o caminho do NeoDownloader no seu computador e FOLDER a pasta de dados dele, então copie o texto da janela.

Se o arquivo de configurações já listar outros servidores, coloque a entrada neodownloader ao lado deles, na mesma lista. O texto não contém senha nem chave: a conexão lê o que precisa da pasta de dados do 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

Pedir uma receita

Escreva ao seu aplicativo na caixa de mensagem, por exemplo: “Crie uma receita do NeoDownloader para example.com.” As suas próprias palavras também servem, assim como a frase que o NeoDownloader prepara.

A mesma janela abre a partir de três lugares:

• Criar uma receita com IA, no topo da aba Receitas, depois que um aplicativo se conectou. A frase ali tem um espaço em branco para o site: coloque o endereço no lugar dele.
• Criar uma receita para este site com IA, no assistente Novo projeto, sob De onde vêm os arquivos?
• Corrigir com IA, em um projeto; veja abaixo.

Depois que um aplicativo se conectou, os passos acima se recolhem em uma linha como Claude Desktop chamou o NeoDownloader pela última vez em …, e Como conectar outro os abre de novo. Sob Diga ao seu agente está a frase, no idioma da janela do NeoDownloader. Copiar copia a frase. Cole-a no seu aplicativo.

A janela aberta a partir do assistente termina com Quando seu agente salvar a receita, o assistente a usa sozinho. Deixe o assistente aberto. Quando a receita é salva, o assistente pergunta de novo aos plugins e diz Seu agente salvou uma receita, e o assistente verificou o endereço de novo.

Quando o aplicativo disser que a receita foi salva, crie um projeto comum com o endereço do site: agora o Crawler usa essa receita, e o projeto baixa os arquivos. A receita também aparece na aba Receitas.

A tela Agente de IA

Agente de IA fica na barra à esquerda, em todas as telas, e a janela chama o aplicativo conectado de agente. Um ponto no item significa que há algo novo ali. O NeoDownloader nunca leva você até lá por conta própria.

No topo da coluna esquerda está o que o aplicativo está fazendo, com o nome dele abaixo, como via Claude Desktop 1.2:

O diário

Abaixo dessa linha fica o diário: uma linha para cada passo do aplicativo, a mais recente embaixo, no idioma da janela do NeoDownloader. A hora aparece no primeiro passo de cada minuto. Quando o nome do aplicativo muda, um título indica o aplicativo seguinte.

• Um passo que falhou tem uma marca na linha; passe o mouse sobre a marca para ver o motivo: Recusado, Parado, Demorou demais ou Falhou.
• Fora do site do rascunho marca um passo que saiu do site para o qual a receita é feita.
• Clique em um passo que abriu uma página para ver essa página de novo.
• Se você rolar para cima, o diário fica onde você está, e Novas: 3 leva você aos passos mais recentes.
• Limpar esvazia o diário na hora, sem perguntar. Receitas e rascunhos ficam.

O aplicativo pode precisar de você para um login ou para uma verificação em um site. O pedido dele fica no diário sob O agente pergunta a você, com Mostrar a página. Faça na página o que ele pede e depois avise o aplicativo.

A página e as receitas

À direita do diário há duas abas. Página aparece enquanto o aplicativo tem uma página aberta e a mostra no navegador do NeoDownloader. Receitas lista as suas receitas. A nova página do aplicativo só toma o painel se você não tiver escolhido Receitas: uma aba que você escolheu fica. Um ponto em uma aba significa que algo novo chegou ali.

Em uma janela estreita há uma só coluna, com Diário, Página e Receitas como abas.

Receitas

A aba Receitas lista as suas próprias receitas: as que o seu aplicativo de IA salvou e as que o editor de receitas de uma versão anterior tenha salvado. As receitas do catálogo não aparecem aqui. A sua própria receita cuida dos sites dela em todos os projetos, com prioridade sobre a do catálogo.

O cartão de uma receita tem o nome, os sites e quando ela foi salva, e pode trazer estas marcas:

• Criada por IA - o seu aplicativo de IA a salvou.
• Com código - ela tem código próprio ao lado.
• Não pode ser lida - o NeoDownloader a ignora até ela ser corrigida; o cartão mostra o que está errado.

Usada no lugar da receita do catálogo: … diz o que a receita substitui.

Excluir pergunta primeiro e diz o que vai cuidar desses sites depois: uma receita do catálogo ou os tipos gerais de página do Crawler. Uma cópia fica ao lado das suas receitas, na pasta .prev. Só você pode excluir uma receita: o aplicativo não pode.

Permitir MCP

Permitir MCP, abaixo da primeira linha da tela, é a permissão do aplicativo. Desligado, o NeoDownloader para de responder a aplicativos de IA por MCP, não importa o que o aplicativo peça, e o que o aplicativo tinha iniciado para, inclusive a página aberta dele. A tela diz MCP desligado: cada chamada de um aplicativo de IA é recusada até você permitir o MCP de novo.

Ele continua desligado depois de reiniciar, até você ligá-lo. Para impedir de vez que o aplicativo trabalhe com o NeoDownloader, remova também o NeoDownloader das configurações do próprio aplicativo.

Corrigir com IA

Um cartão com Corrigir com IA fica na aba Propriedades de um projeto aberto, entre as propriedades do projeto e Excluir o projeto. Ele abre a janela Criar uma receita com IA, com os passos para conectar um aplicativo, se nenhum tiver se conectado ainda. O que a frase pede depende do plugin do projeto.

Em um projeto do Crawler, a frase menciona o site, o endereço e o número de arquivos que a última execução trouxe, e pede ao aplicativo que descubra por que a receita parou de funcionar e a corrija.

Em um projeto de outro plugin não há receita para corrigir, então o aplicativo recebe o pedido de criar uma nova para o endereço. O cartão diz isso: As receitas são para o Crawler, e este projeto baixa com outro plugin. Peça ao seu agente de IA que crie uma receita para este site e depois crie um novo projeto para este endereço com o Crawler. O projeto de onde você partiu fica como estava.

Um projeto cujo plugin não existe mais também tem Corrigir com IA, no aviso no topo da aba, e ele também pede uma nova receita.