Работа с CLI Яндекс Диска через ИИ-агента
Выберите папки Диска, скопируйте их текст на компьютер, читайте документы и работайте с файлами на Диске.
Выберите папки Диска, текст которых хотите искать, обновляйте их копию и работайте с любым файлом на Диске вживую. После этой страницы ваш агент отвечает по выбранным папкам и меняет файлы только там, где вы разрешили. Страница считает, что вы уже вошли.
На этой странице:
- Сначала профиль
- Выберите папки
- Синхронизация
- Что хранит копия
- Читайте синхронизированный документ
- Работа с файлами вживую
- Вывод для скриптов
Сначала профиль
Профиль: имя, которое вы выбираете для одного аккаунта. Это первое слово каждой команды, которой нужен аккаунт:
ydisk personal statusYDISK_PROFILE=personal делает то же самое для одного сеанса оболочки. Профиль никогда не подставляется сам, даже
единственный. Команда без него останавливается с кодом выхода 2 и показывает профили на этом компьютере.
Выберите папки
folders browse показывает Диск по одному уровню, вживую, так что папку можно найти по ее пути:
ydisk personal folders browse
ydisk personal folders browse --folder /Documents
ydisk personal folders add /Documents/ContractsВыбранная папка забирает все, что в ней лежит, вместе с вложенными папками. folders list показывает выбранные
папки, а folders remove убирает одну из них. Следующая синхронизация удалит ее документы из копии.
Выбирайте несколько папок с документами, а не весь Диск. Яндекс Диск не сообщает инструменту, что изменилось, поэтому каждая синхронизация заново перечисляет все выбранные папки и их подпапки. Папка с фотографиями добавляет время на перечисление и не добавляет текста для поиска.
Синхронизация
ydisk personal sync
ydisk personal statussync скачивает файлы, которые появились или изменили содержимое с прошлой синхронизации, и читает их текст. Файл,
удаленный с Диска, пропадает из копии. Файл, перенесенный внутри выбранных папок, сохраняет свои теги и заметки.
Одна синхронизация читает до 200 файлов (--limit) и перечисляет до 10 000 элементов, а потом запоминает, где
остановилась. Большая папка обрабатывается за несколько запусков: запускайте sync снова, пока status не покажет,
что работы не осталось. Остановка ничего не теряет, следующая синхронизация продолжит с того места, где закончила
предыдущая.
Запускайте sync, когда хотите обновить копию, например перед вопросом агенту о свежих файлах. В фоне ничего не
работает. sync --rescan читает все выбранные папки с начала. Выполните его один раз и дальше возвращайтесь к обычной
команде sync.
Выбранную папку, которую вы переименовали или перенесли на Диске, инструмент больше не находит, и ее документы уходят из копии. Добавьте ее снова под новым путем.
Что хранит копия
| На Диске | В копии |
|---|---|
PDF с текстовым слоем, Word .docx, Excel .xlsx, CSV, TSV, обычный текст, Markdown | Текст, имя, путь, размер и даты |
| Отсканированный PDF или картинка | Имя, путь и даты. Текста для чтения нет |
| Любой другой файл и любой файл больше 50 МБ | Имя, путь и даты |
status перечисляет каждый файл, сохраненный только по имени, с причиной. Сами файлы остаются на Диске, а копия
хранит их текст. Время хранится и показывается в UTC.
Читайте синхронизированный документ
ydisk personal documents list
ydisk personal documents show 1a2b3c --json
ydisk personal documents export 1a2b3c --output ./contract.mddocuments show выводит весь текст одного документа, который вы находите по id из search или documents list. Id
выше только пример. documents export записывает документ в новый файл Markdown. Теги, заметки и воспоминания
остаются при документе и никогда не попадают на Диск. Смотрите поиск документа.
Работа с файлами вживую
Команды files работают с Диском напрямую, синхронизация им не нужна. Пути это пути на Диске, например
/Documents/plan.pdf.
ydisk personal files list --folder /Documents
ydisk personal files show /Documents/plan.pdf
ydisk personal files download /Documents/plan.pdf --json
ydisk personal files download /Documents/plan.pdf --output ./plan.pdf
ydisk personal files upload ./notes.md --folder /Documents
ydisk personal files copy /Documents/plan.pdf --folder /Archive
ydisk personal files move /Documents/old.pdf --folder /Archive
ydisk personal files create /Projects/2026
ydisk personal files delete /Documents/old.pdf
ydisk personal files restore trash:/old.pdf
ydisk personal files publish /Documents/plan.pdf
ydisk personal files unpublish /Documents/plan.pdffiles downloadбез--outputотвечает текстом файла, до 200 000 символов, так что агент читает файл вне выбранных папок, не сохраняя его.files deleteпереносит файл в корзину Диска, аfiles restoreвозвращает его по пути в корзине.files publishсоздает публичную ссылку, которую может открыть любой, у кого она есть.files unpublishзакрывает ее.--replaceпри загрузке, копировании или переносе перезаписывает файл, который уже лежит по этому пути.
В терминале инструмент спрашивает перед удалением, перезаписью и публичной ссылкой. Через MCP спросить некого, поэтому
задайте эти разрешения для агента. Смотрите настройки. Добавьте --dry-run к любому
изменению, чтобы увидеть, что оно сделает, и ничего не менять.
Каждая операция API Диска Яндекса тоже есть как команда: ydisk personal api list перечисляет их, а
ydisk personal api show resources-list показывает параметры одной операции, не обращаясь к Яндексу.
Вывод для скриптов
Каждая команда, кроме mcp serve, принимает --json и печатает одно значение JSON в stdout. Ошибки идут в stderr
тоже как JSON, с полем code, по которому можно ветвиться, а у каждого вида сбоя свой код выхода. Их перечисляет
справочник команд.
Дальше: найдите документ или подключите агента.