Notion

История изменений — Notion

Выпущенные возможности Notion CLI: вход, чтение напрямую, локальная копия, синхронизация и поиск.

Заметные изменения @wirecat/notion-cli. Один раздел на версию, новые сверху.

0.2.0 — 16.11.2026

Добавлено

  • notion <profile> sync копирует страницы Notion, страницы внутри страниц, базы данных и их строки в общее хранилище WireCat, с провайдером notion. Без выбранной папки он копирует все, что видит токен. --limit ограничивает один запуск, а --rescan заново проходит по всему. Страница или база данных, которую Notion не отдал, названа в meta.issues и в warnings ответа. Тогда ответ содержит meta.complete: false, а код выхода равен 0. Обход, слишком долгий для одного запуска, вовремя останавливается, и следующая синхронизация его продолжает. Размер выбранных папок не ограничен. Блок внутри страницы, дочерние элементы которого Notion не отдает (синхронизированный блок, к оригиналу которого нет доступа), пропускается с предупреждением. Страница или база данных, на которую Notion отвечает 403, остается как была. Удаляют ее только ответ 404 или корзина. Блок, который Notion не отдает в Markdown страницы, или источник данных, к которому он не принимает запросы, пропускается с предупреждением, а остальное синхронизируется. См. описание синхронизации.
  • Синхронизация идет до 15 минут в терминале и до 45 секунд через MCP, если --timeout не задает другое время (cli-core 0.671.0). Она останавливается до своего срока, и в ежечасном проходе, и в ежедневном обходе, по одному запросу за раз. Она сохраняет, где остановилась, отвечает complete: false и называет sync следующим шагом. Дочерние страницы страницы приходят из ее списка, по 100 за запрос. --timeout, слишком короткий, чтобы что-то сохранить, завершается ошибкой timeout с причиной notion.timeout-too-short. См. описание синхронизации.
  • Одному подключению Notion соответствует один профиль. session start и sync отказываются работать с подключением, которое использует другой профиль с выполненным входом, а профиль, синхронизированный из одного подключения, отклоняет токен другого. Профиль, вошедший через WCNOTION_TOKEN, тоже учитывается. См. описание входа.
  • Страницы внутри страниц и страница в роли выбранной папки теперь синхронизируются. В 0.1.0 говорилось, что они еще не готовы.
  • folders add|list|browse|remove сужают синхронизацию до выбранных страниц и баз данных. folders browse показывает один уровень напрямую из Notion. После удаления последней папки команда сообщает, что следующая синхронизация снова скопирует все рабочее пространство. Через MCP folders add идет через инструмент записи.
  • status, documents list|show|export|context|add, search (синтаксис Lucene, без сети), catalog, tags, relationships, notes, memories, facts и identities: общие команды документов из cli-core для локальной копии. documents add сохраняет одну страницу, прочитанную напрямую из Notion, среди источников, добавленных вручную.

Исправлено

  • Первая синхронизация большой базы данных или страницы с большим числом дочерних страниц продвигается в каждом запуске, в том числе за 45 секунд MCP. Синхронизация читает список папки по одной странице списка и продолжает с того места, где остановилась (childrenPage из cli-core). Раньше база данных больше примерно 12 000 строк останавливала первую синхронизацию через MCP на одном и том же шаге в каждом запуске. См. описание синхронизации.
  • Запросы к базам данных укладываются в документированный лимит Notion, около 3 запросов в секунду, а не 60 в минуту. См. устройство инструмента.
  • folders browse --parent и синхронизированная копия дают странице внутри страницы ссылку в собственной форме Notion, https://app.notion.com/p/{page-id}, вместо пустого url. См. описание синхронизации.

0.1.0 — 15.11.2026

Добавлено

  • Создан из @wirecat/cli-template 0.24.0.
  • api: весь публичный API Notion, по команде на каждую операцию. 61 операция из документа OpenAPI Notion стала командой, notion personal api retrieve-a-page --page-id …, и у каждой свой ключ разрешения, api.<operation>. api list и api show <operation> читают сохраненный документ и не обращаются к Notion. Каждый запрос передает Notion-Version 2026-03-11, поэтому ни одна команда ее не спрашивает. Операция, которая удаляет, в терминале сначала спрашивает. Через MCP ask ее пропускает, поэтому задайте ее ключу deny, чтобы остановить агента. --dry-run ничего не отправляет. Операции с токенами OAuth и две загрузки файлов не предлагаются. Первые входят с секретом клиента подключения и передают токены, вторые отправляют тела multipart. Проверки принимают чуть больше, чем Notion: любое значение JSON не типизировано, а три ограничения (exclusiveMinimum, exclusiveMaximum, maxProperties) отброшены в шести местах, так что нарушение этих ограничений отклоняет сам Notion. Покрытие API.
  • session start | status | end | list с персональным токеном доступа Notion или токеном внутреннего подключения. Токен проверяется в Notion и хранится в связке ключей как token:<profile>. Аккаунтом считаются рабочее пространство и бот токена.
  • documents get читает одну страницу напрямую как Markdown, дочитывает недостающие части длинной страницы и вырезает подпись из подписанных ссылок Notion на файлы. Если страница все еще неполная, ответ содержит meta.complete: false, а код выхода не равен нулю.
  • databases list и databases show: базы данных, которые видит токен, а также id и свойства каждого источника данных.
  • Запросы идут медленнее лимита Notion, а запросы к источникам данных еще медленнее. После отказа инструмент ждет столько, сколько указывает Retry-After от Notion. Запрос через подключение, которое Notion заблокировал, не повторяется.
  • Переменные окружения начинаются с WCNOTION_ (WCNOTION_TOKEN, WCNOTION_PROFILE), а не с NOTION_. Собственный MCP-сервер Notion читает NOTION_TOKEN, и токен, заданный для него, не должен выполнять вход в этот инструмент.
  • Инкрементальный источник синхронизации для Notion, готовый для движка синхронизации cli-core. Он читает изменения с отметки времени с перекрытием, запрашивает каждую базу данных в области синхронизации, раз в день обходит все и удаляет страницу только после того, как Notion подтвердит, что ее нет. Большие базы данных читаются целиком, сверх ограничения Notion в 10 000 строк на запрос. Элемент, который Notion отказывается отдать, пропускается с предупреждением, а прерванная синхронизация продолжается в следующий раз. Пока не поддерживаются страницы внутри страниц и страница в роли выбранной папки. Они ждут cli-core. См. описание синхронизации.