notion-api

Позволяет взаимодействовать с рабочими пространствами Notion через REST API, используя curl и jq.

Суть

Что это за skill и зачем он нужен

Навык Notion API предоставляет набор готовых curl‑запросов и рекомендаций для работы с Notion REST API: аутентификация через переменную окружения `NOTION_API_TOKEN`, управление страницами, блоками, базами данных, комментариями, поиск и пагинацию. Включены рекомендации по обработке ограничений скорости, подтверждению деструктивных операций и обработке ошибок.

Установка

Как установить

npx skills add https://github.com/intellectronica/agent-skills --skill notion-api

Сценарии

Когда использовать

Подходит

Необходимо автоматизировать создание, обновление или удаление страниц, блоков и записей в базах данных Notion.
Требуется интегрировать Notion с другими скриптами или CI/CD‑процессами без использования SDK.
Нужен быстрый способ выполнить поиск по всем объектам рабочего пространства.
Требуется точный контроль над заголовками запросов, параметрами и обработкой ответов JSON.
Необходимо выполнять операции в средах, где доступен только curl и jq.

Не подходит

Для интерактивного редактирования контента предпочтительнее использовать веб‑интерфейс Notion.
Если требуется полноценный клиент с автоматическим управлением токеном и повторными попытками, лучше использовать официальные SDK.
Когда требуется реальное время (webhooks) – данный навык не поддерживает их.
Если у вас нет доступа к переменной `NOTION_API_TOKEN`, навык работать не сможет.
Для сложных бизнес‑логик, требующих обширных трансформаций данных, лучше писать собственный код.

Похожие