Навык Notion от индивидуального разработчика intellectronica: без использования MCP, агент напрямую вызывает REST API Notion с помощью curl и jq для поиска контента, чтения и записи страниц и блоков, запроса и создания баз данных и источников данных, а также чтения и записи комментариев. В файле SKILL.md для каждого эндпоинта приведены примеры запросов.
Количество установок skills.sh 98110 (+518 / 24 ч)
Аудит безопасности: не проводился
- Сканирование еще не выполнено
Обоснование
- Обработка учетных данных четко описана: сначала проверяется переменная окружения NOTION_API_TOKEN, затем используется токен, предоставленный пользователем в диалоге; если ни того, ни другого нет, система запрашивает его у пользователя. Требуется, чтобы токен передавался только в заголовке запроса Authorization, не отображался и не записывался в логи.
- Подтверждение перед изменениями: обновление страниц или блоков, архивирование и удаление, изменение структуры базы данных, пакетное создание страниц — все эти действия требуют предварительного подтверждения от пользователя; для группы связанных операций достаточно одного подтверждения.
- Написано в соответствии с версией Notion 2025-09-03, поддерживаются новые интерфейсы источников данных (data source); приведены примеры пагинации, отката при ограничении частоты запросов 429 и указания на максимальный размер запроса.
- Репозиторий распространяется под лицензией CC0; на skills.sh за последние 24 часов выполнено 518 установок, всего накоплено 98110 установок. За последние 8 недель еженедельное количество установок выросло с 2335 до 5232 (что отражает только уровень интереса).
Использование
- Команда установки будет отображаться после успешного прохождения аудита; навык активируется, когда агенту требуется «читать / изменять страницы Notion» или «запрашивать данные из базы данных Notion».
- Требуется API-токен для интеграции с Notion (задается через переменную окружения NOTION_API_TOKEN), а на локальной машине должны быть установлены утилиты curl и jq.
Риски
- В текущем периоде аудит не проводился, присвоен фиксированный уровень C, команда установки не отображается. В SKILL.md агенту предписано выполнять curl для доступа к api.notion.com и считывать переменную окружения NOTION_API_TOKEN, что соответствует назначению навыка. Аудит от Gen Agent Trust Hub на skills.sh имеет статус Pass.
- Навык не является официальным продуктом Notion; если токен будет вставлен в диалог, он останется в истории переписки, поэтому использование переменной окружения более безопасно.
- Агент обладает возможностью архивировать страницы и удалять блоки; предварительное подтверждение зависит от соблюдения агентом правил. После обновления версии API Notion примеры могут устареть.