К основному содержанию
скилл CX Codex

notion · acedatacloud — скилл для Claude Code: что делает и как установить

Скилл подключает Claude Code к Notion через REST API: он ищет, читает и изменяет страницы, а также работает с базами данных.

Apache-2.0 215 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill notion -a claude-code
Открыть на GitHub

Что делает notion

Скилл использует Notion REST API через curl и jq. Он сначала проверяет авторизацию, затем умеет искать страницы и базы в рабочем пространстве, читать метаданные и содержимое страниц, добавлять абзацы, выполнять запросы к базе и создавать в ней новые страницы.

Для запросов нужны переменная $NOTION_TOKEN с OAuth-токеном и заголовок Notion-Version: 2022-06-28. Интеграция видит только страницы и базы, которыми с ней явно поделились. Без $NOTION_TOKEN и доступа к нужной странице запросы не сработают.

При работе с большими результатами скилл использует курсорную пагинацию через next_cursor. Ошибки записи часто связаны с несовпадением типа свойства, поэтому перед изменением базы стоит прочитать её схему через GET /v1/databases/<id>.

Какие задачи решает

  • найти страницу или базу в рабочем пространстве Notion
  • прочитать содержимое страницы по её идентификатору
  • добавить абзац в существующую страницу
  • отфильтровать записи базы по статусу и отсортировать их
  • создать страницу с заданными свойствами в базе

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

  • Найди в Notion страницу с бюджетом Q1 и покажи её содержимое.
  • Добавь этот отчёт в конец страницы с идентификатором PAGE_ID.
  • Найди в базе DATABASE_ID записи со статусом Open и создай новую запись.

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

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill notion -a claude-code

2Вручную: положить файлы

~/.claude/skills/notion/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/notion/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о notion

Как установить notion в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill notion -a claude-code, затем проверьте файл ~/.claude/skills/notion/SKILL.md.

Что делает скилл notion?

Он связывает Claude Code с Notion REST API. Скилл ищет и читает страницы, добавляет блоки, запрашивает записи баз и создаёт страницы в базах.

Что нужно для работы notion с закрытыми страницами?

Нужен OAuth-токен в $NOTION_TOKEN. Интеграция получит доступ только к страницам и базам, которыми с ней явно поделились.

Исходный текст

SKILL.md · Apache-2.0
---
name: notion
description: Search, read, append to, and create Notion pages and databases via the Notion REST API. Use when the user mentions Notion, a page in their workspace, or wants to log something to a database.
when_to_use: |
  Trigger when the user wants to read or write something in Notion —
  search a workspace, read a page, append blocks, query a database,
  create a page from a template, etc.
connections: [notion]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

We drive the [Notion API](https://developers.notion.com/reference) with
`curl + jq`. The user's OAuth bearer token is in `$NOTION_TOKEN`; every
call needs it plus the `Notion-Version` header.

Notion-Version is currently `2022-06-28` (the most recent stable). Bump
this header when Notion ships a new version.

The user's connection only sees the pages and databases they explicitly
shared with the integration when they authorized. If a search or page
read returns nothing, the most likely cause is "the page was never
shared with the integration" — surface that hint to the user.

## Recipes

### Verify auth (always run first)

```sh
curl -sS https://api.notion.com/v1/users/me \
  -H "Authorization: Bearer $NOTION_TOKEN" \
  -H "Notion-Version: 2022-06-28" \
  | jq '{id, name, type, bot: (.bot != null)}'
```

### Search the workspace

```sh
curl -sS https://api.notion.com/v1/search \
  -H "Authorization: Bearer $NOTION_TOKEN" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d '{"query": "Q1 budget", "page_size": 10}' \
  | jq '.results[] | {id, type: .object, url, title: (.properties.title // .properties.Name)?.title?[0]?.plain_text // .child_page?.title}'
```

### Read a page (metadata only)

```sh
curl -sS "https://api.notion.com/v1/pages/PAGE_ID" \
  -H "Authorization: Bearer $NOTION_TOKEN" \
  -H "Notion-Version: 2022-06-28"
```

### Read a page's full content

```sh
curl -sS "https://api.notion.com/v1/blocks/PAGE_ID/children?page_size=100" \
  -H "Authorization: Bearer $NOTION_TOKEN" \
  -H "Notion-Version: 2022-06-28" \
  | jq '.results[] | {type, content: (.[.type] // {})}'
```

### Append a paragraph to a page

```sh
curl -sS -X PATCH "https://api.notion.com/v1/blocks/PAGE_ID/children" \
  -H "Authorization: Bearer $NOTION_TOKEN" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc --arg text "Appended via the assistant." '
    {children: [{
      object: "block",
      type: "paragraph",
      paragraph: {rich_text: [{type:"text", text:{content:$text}}]}
    }]}')"
```

### Query a database

```sh
curl -sS -X POST "https://api.notion.com/v1/databases/DATABASE_ID/query" \
  -H "Authorization: Bearer $NOTION_TOKEN" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {"property": "Status", "select": {"equals": "Open"}},
    "sorts":  [{"property": "Updated", "direction": "descending"}],
    "page_size": 25
  }'
```

### Create a page in a database

```sh
curl -sS -X POST "https://api.notion.com/v1/pages" \
  -H "Authorization: Bearer $NOTION_TOKEN" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc \
        --arg db "DATABASE_ID" \
        --arg title "New entry" \
        '{
          parent: {database_id: $db},
          properties: {
            Name:   {title: [{text: {content: $title}}]},
            Status: {select: {name: "Open"}}
          }
        }')"
```

## Notes

- Notion's pagination is cursor-based: append `start_cursor=$cursor` to
  paginate, using the `next_cursor` from each response. Stop when
  `has_more` is `false`.
- Most write failures (400/404) come from a property type mismatch —
  e.g. sending `{"select": "Open"}` instead of `{"select": {"name": "Open"}}`.
  Read the database schema once via `GET /v1/databases/<id>` if unsure.


## Record the output

After you successfully publish and obtain the live result URL, call the built-in
`publish_artifact` tool ONCE so the user can track this deliverable in **My Outputs**:

```
publish_artifact(kind="document", channel="notion", title="<title>", url="<the REAL returned URL>", status="delivered")
```

Use the real returned URL — never fabricate one. Call it once per published item,
only after delivery is confirmed; skip it (or use `status="failed"`) if publishing failed.
See `_shared/artifacts.md`.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →

Сначала — notion от других авторов.

notion openclaw Скилл связывает агента с Notion через ntn CLI и API: он помогает читать и менять страницы, запрашивать data sources и загружать файлы. CX Codex +1 5 700установок notion membrane Подключает Notion к агенту через Membrane CLI. Агент читает базы данных, создаёт страницы и обновляет блоки прямо из чата. CX Codex +1 357установок notion imoonkey Скилл даёт агенту доступ к рабочему пространству Notion: искать страницы, читать содержимое, запрашивать базы данных и создавать записи. CX Codex +1 ★ 79звёзд репо c-notion daxaur Скилл c-notion для Claude Code учит агента работать со страницами и базами Notion через notion-cli: искать, создавать, обновлять записи и блоки без открытия браузера. CX Codex +1 ★ 179звёзд репо notion-api intellectronica Скилл для взаимодействия с Notion API через REST-запросы. Даёт агенту полный доступ к страницам, базам данных, блокам и комментариям — читать, создавать, обновлять и удалять контент. CX Codex +1 106 200установок notion-automation claude-office-skills Скилл notion-automation для Claude Code автоматизирует базы Notion и переносит события между сервисами. Шаблоны n8n охватывают ведение лидов и проектных задач. CX Codex +1 5 000установок notion-sdk terrylica Скилл notion-sdk для Claude Code и Codex, работает с Notion через официальный Python SDK. Создаёт страницы и базы данных, запрашивает информацию, добавляет блоки контента — всё программно, без ручного ввода. CX Codex +1 133установок notion_integration vuralserhat86 Скилл notion_integration для Claude Code ищет и оформляет материалы в Notion, готовит документы к встречам и разбивает спецификации на задачи, связывая рабочие заметки и планы с проектом. CX Codex +1 1установок notion-as-code makenotion Задаёт порядок работы с Notion as Code в App: перед изменениями агент читает инструкции SDK. Помогает создавать и отлаживать такой код. CX Codex +1 ★ 232звёзд репо

Из того же набора67

Весь набор →
tencentcloud-cls-alarm Скилл tencentcloud-cls-alarm для Claude Code управляет тревогами Tencent Cloud CLS: политиками, группами уведомлений, временными глушителями и журналом срабатываний. Настраивает и проверяет оповещения. CX Codex +1 216установок linkedin Публикует текстовые и ссылочные посты в личной ленте LinkedIn через Posts API. Перед отправкой просит подтвердить текст. CX Codex +1 215установок gitlab Скилл учит агента работать с GitLab через glab: заводить issue, смотреть merge request, гонять пайплайны и искать по коду. CX Codex +1 215установок slack Ищет сообщения в открытых каналах Slack и отправляет ответы бота после подтверждения пользователя. CX Codex +1 215установок onepage-pdf Скилл onepage-pdf рендерит HTML-документ в один непрерывный высокий PDF-лист без разрывов страниц через headless Chrome и обрезает пустоту с помощью PyMuPDF. CX Codex +1 214установок devto Публикует статьи на dev.to, обновляет посты и собирает статистику просмотров и реакций через Forem API v1 прямо из терминала. CX Codex +1 213установок reddit Ищет обсуждения на Reddit, читает правила сабреддитов, отвечает и публикует посты. Работает с тредами и профилем через OAuth или cookies. CX Codex +1 212установок cos-upload Скилл cos-upload загружает локальные файлы в CDN AceData Cloud и возвращает публичную ссылку для передачи в другие API. CX Codex +1 211установок

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой