list_notes

macOS

Назначение

Перечисляет заметки из Apple Notes. Можно отфильтровать по папке. Постраничный вывод: `limit` ограничен 500 на вызов, поэтому используйте `offset` (offset=500 возвращает заметки 501–1000), а не запрашивайте больший лимит. Ответ содержит `total` — общее число совпадающих заметок — и `has_more` — остались ли элементы после этой страницы, поэтому не нужно гадать, получены ли все данные: переходите по страницам, пока `has_more` не станет false. Это точно даже при `total_is_estimated`, указывающем, что число является лишь нижней оценкой. Чтобы прочитать ВСЮ библиотеку, передайте order="id"; см. параметр order.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

• Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

{
  "properties": {
    "folder": {
      "type": "string"
    },
    "limit": {
      "default": "50",
      "description": "Notes per page (default 50, capped at 500). To get more, page with offset.",
      "type": "integer"
    },
    "offset": {
      "default": "0",
      "description": "How many notes to skip (default 0). offset=500 with limit=500 returns notes 501-1000. An offset past the end returns an empty page with has_more=false, not an error.",
      "minimum": 0,
      "type": "integer"
    },
    "order": {
      "default": "modified",
      "description": "order: \"modified\" (default) sorts newest-modified first — what you want to SHOW someone, but NOT safe for paging: modification date changes, so a note edited between two calls jumps to the front and another note is pushed past your cursor and never returned. \"id\" sorts by the note's immutable store id — stable, never renumbered, new notes append at the end — so use order=\"id\" to walk an entire library page by page: edits and insertions mid-crawl are safe with it. One case it cannot cover, because pages are addressed by offset: if a note is DELETED mid-crawl, every note after the hole shifts one slot back and the note that was on the page boundary is skipped, silently. If completeness matters, re-run the crawl and reconcile against total, or crawl while nothing is deleting notes.",
      "type": "string"
    }
  },
  "type": "object"
}

Пример для документации

Пример документации для list_notes. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "limit": 5
}