Документы и файлыYandex Disk

Работа с CLI Яндекс Диска через ИИ-агента

Выберите папки Диска, скопируйте их текст на компьютер, читайте документы и работайте с файлами на Диске.

Выберите папки Диска, текст которых хотите искать, обновляйте их копию и работайте с любым файлом на Диске вживую. После этой страницы ваш агент отвечает по выбранным папкам и меняет файлы только там, где вы разрешили. Страница считает, что вы уже вошли.

На этой странице:

  1. Сначала профиль
  2. Выберите папки
  3. Синхронизация
  4. Что хранит копия
  5. Читайте синхронизированный документ
  6. Работа с файлами вживую
  7. Вывод для скриптов

Сначала профиль

Профиль: имя, которое вы выбираете для одного аккаунта. Это первое слово каждой команды, которой нужен аккаунт:

ydisk personal status

YDISK_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 status

sync скачивает файлы, которые появились или изменили содержимое с прошлой синхронизации, и читает их текст. Файл, удаленный с Диска, пропадает из копии. Файл, перенесенный внутри выбранных папок, сохраняет свои теги и заметки.

Одна синхронизация читает до 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.md

documents 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.pdf
  • files 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, по которому можно ветвиться, а у каждого вида сбоя свой код выхода. Их перечисляет справочник команд.

Дальше: найдите документ или подключите агента.