notion · acedatacloud — скилл для Claude Code: что делает и как установить
Скилл подключает Claude Code к Notion через REST API: он ищет, читает и изменяет страницы, а также работает с базами данных.
Apache-2.0 215 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill notion -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/notion/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/notion/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill notion -a codex2Вручную: положить файлы
.agents/skills/notion/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill notion -a cursor2Вручную: положить файлы
.cursor/skills/notion/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/notion2Вручную: положить файлы
.github/skills/notion/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill notion -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/notionВручную: положить файлы
.devin/skills/notion/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill notion -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.