Яндекс Диск
Скопируйте текст выбранных папок Яндекс Диска на компьютер: агент найдет файл по тому, что в нем написано, и поработает с файлами, если вы разрешите.
Договоры, отчеты и заметки лежат на Яндекс Диске, и ИИ-агент на вашем компьютере не может их прочитать, пока вы не
скачаете каждый файл и не вставите его в чат. Инструмент командной строки ydisk копирует на ваш компьютер текст
выбранных папок Диска. После этого агент находит файл, где упоминается бюджет, клиент или дата, цитирует его и
называет путь к файлу на Диске, даже без интернета. Когда нужно, тот же инструмент показывает, скачивает, загружает,
перемещает файлы на Диске и открывает к ним доступ по ссылке.
Для начала нужны Node.js 22.16 или новее в ветке 22.x либо 24 и новее и OAuth-токен Яндекса: ключ, с которым инструмент работает с вашим Диском. Здесь вы узнаете, как устроена копия, как получить токен и как подключить первую папку.
На этой странице:
- Как это устроено
- Установка и вход
- Скопируйте папку и ищите по ней
- Подключите агента
- Работа с файлами на Диске
- Ограничения
- Справочник
Как это устроено
- Копия текста на вашем компьютере.
ydiskчитает выбранные папки и сохраняет текст их файлов в локальном хранилище. Это один файл базы данных на вашем компьютере, общий для всех инструментов WireCat. Поиск читает эту копию, а не Диск. - Только выбранные папки. Добавьте несколько папок, а не весь Диск. Яндекс Диск не сообщает, что изменилось, поэтому каждая синхронизация заново перечисляет все выбранные папки с вложенными и скачивает только измененные файлы.
- Текст, а не копии файлов. Инструмент читает Markdown, обычный текст, PDF с текстовым слоем, Word
.docx, Excel.xlsx, CSV и TSV. Остальные файлы, например фото, сохраняются только по имени. Сами файлы остаются на Диске. - Профиль для каждого аккаунта. Профиль - имя, которое вы даете одному аккаунту Яндекса, например
personalилиwork. Каждая команда для аккаунта начинается с него:ydisk personal search budget. - Команды
filesменяют Диск. Они работают с Яндексом напрямую. Удаление переносит файл в корзину Диска. В терминале инструмент спрашивает перед удалением, перезаписью или публичной ссылкой. По MCP спросить некого, поэтому для агента, которому это нельзя, поставьте этим правамdeny.
Установка и вход
Скоро. ydisk ещё нет в npm. Команда установит его, когда выйдет первый выпуск.
- Установите инструмент из npm и проверьте его:
npm install -g @wirecat/yandex-disk-cli
ydisk --version
ydisk doctor-
Получите токен. Яндекс выдает его приложению, которое вы регистрируете, а получить его можно по одной ссылке (инструкция Яндекса):
- Зарегистрируйте приложение на oauth.yandex.ru. На шаге "Платформы
приложения" выберите "Веб-сервисы" и укажите Redirect URI
https://oauth.yandex.ru/verification_code. - Дайте ему доступы
cloud_api:disk.read,cloud_api:disk.infoи, чтобы менять файлы,cloud_api:disk.write. - Откройте
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>с ClientID вашего приложения, нажмите "Разрешить" и скопируйте токен со страницы.
- Зарегистрируйте приложение на oauth.yandex.ru. На шаге "Платформы
приложения" выберите "Веб-сервисы" и укажите Redirect URI
-
Войдите под именем профиля, которое выберете сами. Инструмент спросит токен скрытым вводом, проверит его у Яндекса и сохранит в системной связке ключей, а там, где ее нет, в закрытом файле.
ydisk personal session start
ydisk personal session status --checkКогда Яндекс перестанет принимать токен, снова выполните session start с новым токеном.
Скопируйте папку и ищите по ней
folders browse показывает Диск по одному уровню, чтобы выбрать папку по ее пути:
ydisk personal folders browse
ydisk personal folders add /Documents
ydisk personal sync
ydisk personal search "quarterly budget"Одна синхронизация читает до 200 файлов (--limit), проходит примерно до 10 000 элементов и запоминает, где остановилась. Запустите ее снова, чтобы
продолжить, а позже, чтобы получить изменения. ydisk personal status показывает последнюю синхронизацию и оставшуюся
работу. documents show выводит весь текст одного найденного файла.
Подключите агента
Терминальный агент, например Claude Code, получает навык инструмента:
ydisk skill installДальше просите обычными словами:
Используй ydisk CLI с профилем personal. Найди в моих папках на Диске договор с Harbour Ltd.
Процитируй условия оплаты и назови путь к файлу на Диске. Ничего не меняй в файлах.Сначала агент ищет в локальной копии. Файл вне выбранных папок он читает прямо с Диска. Приложение, которое
подключается к MCP-серверам, получает те же команды через ydisk personal mcp serve.
Работа с файлами на Диске
ydisk personal files list --folder /Documents
ydisk personal files download /Documents/plan.pdf --output ./plan.pdf
ydisk personal files upload ./notes.md --folder /Documents
ydisk personal files move /Documents/old.pdf --folder /Archive
ydisk personal files delete /Documents/old.pdf
ydisk personal files publish /Documents/plan.pdffiles delete переносит файл в корзину Диска, а files restore возвращает его. files publish создает ссылку,
которую может открыть любой, у кого она есть. В терминале инструмент спрашивает перед удалением, перезаписью с
--replace и публичной ссылкой. По MCP спросить некого, поэтому для агента, которому это нельзя, поставьте права
files.delete=deny и files.share=deny. YDISK_READ_ONLY=1 запрещает любые изменения.
Ограничения
- В сканированных PDF и картинках нет текста для поиска.
- Выбранная папка, которую вы переименовали или перенесли на Диске, перестает синхронизироваться, и ее копии уходят из хранилища. Добавьте ее снова по новому пути.
- Вход только по вставленному токену. Входа через браузер пока нет.
Справочник
Все команды и параметры: команды. Настройки и права: настройки. Что попадает на диск и в сеть: безопасность. Справочник на английском.