Робота з AI-застосунком
Якщо NeoDownloader не може завантажити з якогось сайту або завантажує з нього не те, що потрібно, це можна виправити за допомогою AI-застосунку: він вивчає сайт і пише рецепт, короткий опис того, де сайт тримає файли. У NeoDownloader немає вбудованого AI, але до нього може під'єднуватися ваш застосунок, і у вікні програми він називається агентом. Під'єднується він через MCP: це спільний спосіб, у який AI-застосунки працюють з іншими програмами. На цій сторінці - для чого це потрібно, як під'єднати застосунок, екран AI-агент і Полагодити з AI.
Для чого це
Краулер це плагін, який обходить сторінки сайту й забирає знайдені на них файли. Він працює за рецептами: рецепт підказує, де сайт тримає свої файли і як їх гортати.
Для сайтів, які він знає, у Краулера є рецепт, написаний саме для цього сайту. Для всіх інших він бере один із чотирьох загальних рецептів, по одному на кожен вид сторінки: наприклад, галерея або тема форуму. Такий рецепт нічого не знає про конкретний сайт, тому справляється не завжди.
Якщо він не дає нічого або дає не те, що ви хотіли, ваш AI-застосунок може написати рецепт для цього сайту. Те саме, якщо рецепт перестав знаходити файли після змін на сайті: застосунок його полагодить.
Рецепт створюється один раз. Відтоді він обслуговує свій сайт у кожному проєкті, а запускам застосунок не потрібен. Сам застосунок нічого не завантажує: його тестовий запуск лише перелічує файли, а завантажує проєкт, який запускаєте ви. Застосунок працює на вашій передплаті або на безкоштовній моделі, якщо вона в ньому є.
Спершу спробуйте звичайний проєкт, бо види сторінок Краулера часто справляються за секунди там, де застосунку потрібні хвилини. Якщо ви радше зачекаєте на нас, ніж робитимете рецепт, скористайтеся Попросити нас зробити рецепт для цього сайту.
Рецепти читає лише Краулер. Video Downloader, Gallery Downloader і Прямі посилання їх не читають.
Що застосунок може бачити й робити
Застосунок працює відкрито: кожен його крок - це рядок у журналі, описаному нижче. Що він отримує, чого не може робити й куди можуть потрапити його відповіді, написано в розділі AI-застосунок, який ви під'єднуєте. Прочитайте це, перш ніж під'єднувати застосунок, насамперед якщо ви ввійшли на сайти в браузері NeoDownloader.
Якщо ви працюєте з безкоштовною моделлю в OpenCode, подивіться на неї до роботи. Список OpenCode каже, що кожна безкоштовна модель робить із вашими даними. На момент написання DeepSeek V4.1 Flash Free і GLM-5.3-Flash Free нічого не зберігають і не навчаються на них, а інші можуть зберігати їх 30 днів або використовувати для покращення моделі.
Під'єднайте свій застосунок
Немає AI-застосунку? Почніть тут.
Це робиться один раз, на комп'ютері, де працює NeoDownloader.
- Клацніть AI-агент на панелі ліворуч.
- Клацніть Як під'єднати, під першим рядком екрана.
- У вікні Зробити рецепт з AI, під заголовком Під'єднайте свій AI-застосунок, виберіть свій застосунок у списку.
- Для Claude Desktop, ChatGPT / Codex і OpenCode натисніть Додати до Claude Desktop, Додати до ChatGPT / Codex або Додати до OpenCode: NeoDownloader сам внесе запис у файл налаштувань застосунку. Для інших застосунків зробіть те, що каже вікно. Копіювати копіює текст, і шляхи вашого комп'ютера в ньому вже є.
- Перезапустіть свій AI-застосунок. Сам NeoDownloader перезапускати не потрібно.
Кнопка більше нічого у файлі не змінює і лишає старий файл поруч, із .before-neodownloader наприкінці імені. Якщо вона не може прочитати файл, вона його не чіпає й відкриває текст під Додати вручну. Це посилання працює і саме по собі.
Поки застосунок працює, NeoDownloader має бути запущений. Якщо його закрито, застосунок про це дізнається і має попросити вас запустити його.
Куди вставляти текст
Вікно показує текст, готовий до вставлення. Нижче вказано, куди він іде в кожному застосунку і який має вигляд. У цих зразках PROGRAM означає шлях до NeoDownloader на вашому комп'ютері, а FOLDER його теку даних, тому копіюйте текст із вікна.
Якщо у файлі налаштувань уже перелічено інші сервери, поставте запис neodownloader поруч із ними, у тому самому списку. У тексті немає ні пароля, ні ключа: з'єднання бере потрібне з теки даних NeoDownloader.
Claude Desktop
Додайте це до файлу для вашої системи:
- 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
Виконайте це в терміналі:
claude mcp add --scope user neodownloader -- PROGRAM --mcp --install-dir FOLDER
ChatGPT / Codex
Додайте це до ~/.codex/config.toml, у Windows до %USERPROFILE%\.codex\config.toml:
[mcp_servers.neodownloader]
command = "PROGRAM"
args = ["--mcp", "--install-dir", "FOLDER"]
Цей файл читають застосунок ChatGPT для комп'ютера і Codex. ChatGPT у браузері під'єднатися не може, тому встановіть застосунок.
Cursor
Додайте це до ~/.cursor/mcp.json, у Windows до %USERPROFILE%\.cursor\mcp.json:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
VS Code
Відкрийте Command Palette > MCP: Open User Configuration і додайте це:
{
"servers": {
"neodownloader": {
"type": "stdio",
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
GitHub Copilot CLI
Додайте це до ~/.copilot/mcp-config.json, у Windows до %USERPROFILE%\.copilot\mcp-config.json:
{
"mcpServers": {
"neodownloader": {
"type": "local",
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"],
"tools": ["*"]
}
}
}
OpenCode
Додайте це до ~/.config/opencode/opencode.json, у Windows до %USERPROFILE%\.config\opencode\opencode.json:
{
"mcp": {
"neodownloader": {
"type": "local",
"command": ["PROGRAM", "--mcp", "--install-dir", "FOLDER"],
"enabled": true
}
}
}
Antigravity
Додайте це до ~/.gemini/config/mcp_config.json, у Windows до %USERPROFILE%\.gemini\config\mcp_config.json:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Windsurf
Відкрийте Cascade > MCP > Open MCP config file і додайте це:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
JetBrains AI Assistant
Відкрийте Settings | Tools | AI Assistant | Model Context Protocol (MCP) | Add і додайте це:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Zed
Відкрийте Command Palette > zed: open settings file і додайте це:
{
"context_servers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Cline
Відкрийте MCP Servers > Configure > Configure MCP Servers і додайте це:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Roo Code
Відкрийте MCP > Edit Global MCP і додайте це:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Kiro
Додайте це до ~/.kiro/settings/mcp.json, у Windows до %USERPROFILE%\.kiro\settings\mcp.json:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
LM Studio
Відкрийте Program > Install > Edit mcp.json і додайте це:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Інший
Для будь-якого іншого застосунку, що під'єднується через MCP і вміє запускати програми на вашому комп'ютері, вікно дає команду та її аргументи:
command: PROGRAM
args: --mcp --install-dir FOLDER
Багато застосунків приймають той самий текст, що й Cursor. Застосунок, який ходить лише до серверів в інтернеті, під'єднатися не може, бо це з'єднання залишається на вашому комп'ютері.
Попросіть рецепт
Напишіть застосунку в полі повідомлення, наприклад: «Зроби рецепт NeoDownloader для example.com.» Підійдуть і ваші слова, і речення, яке готує NeoDownloader.
Те саме вікно відкривається з трьох місць:
- Зробити рецепт з AI угорі вкладки Рецепти, коли застосунок уже під'єднався. Речення там має пропуск для сайту: впишіть на його місце адресу.
- Зробити рецепт для цього сайту з AI у майстрі Новий проєкт, під Звідки завантажувати файли?
- Полагодити з AI на проєкті; див. нижче.
Коли застосунок під'єднався, наведені вище кроки згортаються в рядок на кшталт Останнім до NeoDownloader звертався Claude Desktop: …, а Як під'єднати ще один знову їх відкриває. Під Скажіть агентові стоїть речення мовою вікна NeoDownloader. Копіювати копіює його. Вставте його у свій застосунок.
Вікно, відкрите з майстра, закінчується словами Коли агент збереже рецепт, майстер підхопить його сам. Лишіть майстер відкритим. Коли рецепт збережено, майстер знову опитує плагіни й каже Ваш агент зберіг рецепт, і майстер ще раз перевірив адресу.
Коли застосунок скаже, що рецепт збережено, створіть звичайний проєкт з адресою сайту: тепер Краулер працює за цим рецептом, а проєкт завантажує файли. Рецепт з'явиться і на вкладці Рецепти.
Екран «AI-агент»
AI-агент є на панелі ліворуч на кожному екрані, а під'єднаний застосунок вікно називає агентом. Крапка на цьому пункті означає, що там є щось нове. Сам NeoDownloader ніколи вас туди не переводить.
Угорі лівої колонки показано, що робить застосунок, а під цим - його назву, наприклад через Claude Desktop 1.2:
| Рядок повідомляє | Що це означає |
|---|---|
| AI-агент ще не під'єднаний | Жоден застосунок ще не звертався до цього NeoDownloader. |
| AI-агент працює | Застосунок звертався протягом останньої хвилини. |
| AI-агент зараз нічого не робить | Застосунок під'єднано, і зараз він мовчить. |
| AI-агента зупинено | Дозволити MCP вимкнено. |
| Агент просить вас | Застосунок чекає на вас. |
Журнал
Під цим рядком - журнал: по одному рядку на кожен крок застосунку, найновіший унизу, мовою вікна NeoDownloader. Час стоїть біля першого кроку кожної хвилини. Коли назва застосунку змінюється, заголовок називає наступний застосунок.
- Крок, який не вдався, має позначку в рядку; наведіть на неї вказівник, щоб побачити причину: Відмовлено, Зупинено, Задовго або Збій.
- Поза сайтом чернетки позначає крок, який вийшов за межі сайту, для якого пишеться рецепт.
- Клацніть крок, який відкривав сторінку, щоб побачити цю сторінку знову.
- Якщо прокрутити вгору, журнал лишається там, де ви є, а Нових: 3 переводить до останніх кроків.
- Очистити одразу спорожняє журнал, нічого не питаючи. Рецепти й чернетки лишаються.
Застосунку можете знадобитися ви: для входу чи перевірки на сайті. Його прохання стоїть у журналі під Агент просить вас, разом із Показати сторінку. Зробіть на сторінці те, про що він просить, а потім скажіть про це застосунку.
Сторінка й рецепти
Праворуч від журналу - дві вкладки. Сторінка є, поки в застосунку відкрита сторінка, і показує її в браузері NeoDownloader. Рецепти перелічує ваші рецепти. Нова сторінка застосунку займає панель, лише якщо ви не вибрали Рецепти: вибрана вами вкладка лишається. Крапка на вкладці означає, що там з'явилося щось нове.
У вузькому вікні одна колонка, а Журнал, Сторінка і Рецепти стають вкладками.
Рецепти
На вкладці Рецепти перелічено ваші власні рецепти: ті, що зберіг ваш AI-застосунок, і ті, що зберіг редактор рецептів попередньої версії. Рецептів із каталогу тут немає. Ваш власний рецепт обслуговує свої сайти в кожному проєкті, і рецепт каталогу йому поступається.
На картці рецепта - його назва, сайти й час збереження, а ще на ній можуть бути такі позначки:
- Зробив AI - його зберіг ваш AI-застосунок.
- З кодом - поруч із ним є власний код.
- Не читається - NeoDownloader пропускає його, доки його не виправлять; картка показує, що не так.
Працює замість рецепта каталогу: … каже, що саме цей рецепт замінює.
Видалити спершу запитує й каже, що обслуговуватиме ці сайти потім: рецепт із каталогу або загальні види сторінок Краулера. Копія лишається поруч із вашими рецептами, у папці .prev. Видалити рецепт можете лише ви: застосунок цього не може.
Дозволити MCP
Дозволити MCP, під першим рядком екрана, - це дозвіл для застосунку. Коли його вимкнено, NeoDownloader перестає відповідати AI-застосункам через MCP, хай що застосунок запитує, а все, що застосунок почав, зупиняється, зокрема його відкрита сторінка. На екрані написано MCP вимкнено: кожен виклик AI-застосунку відхиляється, доки ви знову не дозволите MCP.
Після перезапуску він лишається вимкненим, доки ви його не ввімкнете. Щоб застосунок остаточно перестав працювати з NeoDownloader, видаліть NeoDownloader ще й із налаштувань самого застосунку.
Полагодити з AI
Картка з Полагодити з AI стоїть на вкладці Властивості відкритого проєкту, між властивостями проєкту і Видалити проєкт. Вона відкриває вікно Зробити рецепт з AI, із кроками під'єднання застосунку, якщо жоден ще не під'єднаний. Про що просить речення, залежить від плагіна проєкту.
У проєкті Краулера речення називає сайт, адресу й кількість файлів, які приніс останній запуск, і просить застосунок з'ясувати, чому рецепт перестав працювати, і виправити його.
У проєкті іншого плагіна рецепта для виправлення немає, тому застосунок просять зробити новий для цієї адреси. Картка так і каже: Рецепти потрібні Краулеру, а цей проєкт завантажує іншим плагіном. Попросіть свого AI-агента зробити рецепт для цього сайту, а потім створіть новий проєкт для цієї адреси з Краулером. Проєкт, з якого ви почали, лишається таким, як був.
Проєкт, плагіна якого більше немає, теж має Полагодити з AI - у попередженні вгорі вкладки, і там теж просять новий рецепт.