AIKraft/AI/Войти
AIKraft/Skills/notion-api

notion-api

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

intellectronica official Разработка ★ 294

Что делает навык

Навык обеспечивает взаимодействие с Notion API (REST) для чтения, создания, обновления и удаления страниц, баз данных, блоков и комментариев. Он обрабатывает аутентификацию, пагинацию, лимиты запросов и ошибки, предоставляя готовые curl-запросы.

Когда применять

  • Поиск страниц и баз данных в рабочем пространстве Notion
  • Чтение содержимого страниц (блоков) и свойств
  • Создание новых страниц, блоков или баз данных
  • Обновление свойств страниц, заголовков блоков или архивация контента
  • Управление комментариями на страницах и блоках

Как работает

  1. Проверить наличие переменной окружения NOTION_API_TOKEN или запросить ключ у пользователя через AskUserQuestion
  2. Выполнить запросы к https://api.notion.com с заголовками Authorization, Notion-Version (2025-09-03) и Content-Type
  3. При операциях изменения или удаления данных запросить подтверждение у пользователя
  4. Обработать ответы API, включая пагинацию (next_cursor) и ошибки (например, 429 с экспоненциальной задержкой)
  5. Использовать curl и jq для выполнения REST-вызовов или писать скрипты по необходимости

Примеры запросов агенту

Найди все страницы в Notion, содержащие слово 'отчет'
Создай новую страницу в базе данных с ID 'db-id' и заголовком 'Задача 1'
Добавь новый блок с текстом 'Итог' в конец страницы с ID 'page-id'

Что понадобится

  • Переменная окружения NOTION_API_TOKEN или предоставленный пользователем ключ
  • Инструменты curl и jq для выполнения REST-запросов
  • Доступ к интеграции Notion с соответствующими правами

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «notion-api» из репозитория: # https://github.com/intellectronica/agent-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r notion-api/ ~/.claude/skills/notion-api/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.