NeoDownloader
Разделы справки

Настройки

Бесплатная версия и Premium

Все разделы справки

Работа с 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.

  1. Нажмите AI-агент на панели слева.
  2. Нажмите Как подключить, под первой строкой экрана.
  3. В окне Сделать рецепт с AI, под заголовком Подключите своё AI-приложение, выберите своё приложение в списке.
  4. Для Claude Desktop, ChatGPT / Codex и OpenCode нажмите Добавить в Claude Desktop, Добавить в ChatGPT / Codex или Добавить в OpenCode: NeoDownloader сам внесёт запись в файл настроек приложения. Для остальных приложений сделайте то, что написано в окне. Копировать забирает текст, и пути вашего компьютера в нём уже стоят.
  5. Перезапустите 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 тоже есть - в предупреждении вверху вкладки, и там фраза тоже просит новый рецепт.