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. После удаления последней папки команда сообщает, что следующая синхронизация снова скопирует все рабочее пространство. Через MCPfolders 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-template0.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-Version2026-03-11, поэтому ни одна команда ее не спрашивает. Операция, которая удаляет, в терминале сначала спрашивает. Через MCPaskее пропускает, поэтому задайте ее ключу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. См. описание синхронизации.