스킬 notion-api
📦

notion-api

낮은 위험 🌐 네트워크 접근

公式REST APIでNotionワークスペースに接続する

또한 다음에서 사용할 수 있습니다: BLTGV

Notionコンテンツのを手動管理することは時間がかかります。このスキルにより、Claude、Codex、Claude Codeは、適切な認証とエラー処理を備えた公式Notion APIを通じて、ページ、データベース、ブロックをプログラムで読み取り、作成、更新できます。

지원: Claude Codex Code(CC)
🥉 73 브론즈
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"notion-api" 사용 중입니다. Search Notion for "meeting notes"

예상 결과:

Found 3 matching pages:

| Title | ID | Last Edited |
|-------|-----|-------------|
| Q1 Meeting Notes | abc123 | 2024-01-15 |
| Team Standup Notes | def456 | 2024-01-14 |
| Project Kickoff Notes | ghi789 | 2024-01-10 |

"notion-api" 사용 중입니다. Query tasks database for incomplete items

예상 결과:

Showing 5 incomplete tasks from the Tasks database:

| Task | Assignee | Due Date | Status |
|------|----------|----------|--------|
| Review PR #42 | @sarah | Jan 20 | Not started |
| Update documentation | @alex | Jan 22 | In progress |
| Deploy staging | @jordan | Jan 23 | Not started |

"notion-api" 사용 중입니다. Create page titled "Sprint Planning"

예상 결과:

Successfully created page "Sprint Planning" in the Sprint Notes database.

Page ID: xyz789abc
Created at: 2024-01-16T10:30:00.000Z
URL: https://notion.so/xyz789abc

보안 감사

낮은 위험
v1 • 4/23/2026

This is a legitimate Notion API documentation skill that requires network access to interact with the Notion API. Static analysis flagged 802 potential issues, but all are false positives: backtick detection triggered by markdown code fences, URL detection from official API documentation, and environment variable patterns from authentication examples. The skill implements proper security practices including user confirmation for destructive operations and explicit instructions to never expose API tokens.

5
스캔된 파일
2,697
분석된 줄 수
3
발견 사항
1
총 감사 수
낮은 위험 문제 (2)
Network Access Required
This skill makes REST API calls to api.notion.com. Network access is required for the skill to function.
API Key Environment Variable Access
The skill accesses NOTION_API_TOKEN environment variable for authentication with the Notion API.
감사자: claude

품질 점수

45
아키텍처
100
유지보수성
87
콘텐츠
50
커뮤니티
86
보안
91
사양 준수

만들 수 있는 것

Notionからナレッジベースを構築する

プロジェクトドキュメント、会議メモ、研究資料をNotionデータベースから他のシステムや形式に自動的に同期します。

Notionデータからレポートを生成する

特定のフィルターでNotionデータベースをクエリし、要約、ダッシュボード、または自動ステータスレポートにデータを集約します。

Notionのコンテンツ作成を自動化する

外部トリガーやスケジュールされたワークフローに基づいて、構造化されたページを作成したり、プロパティを更新したり、既存のページにブロックを追加したりします。

이 프롬프트를 사용해 보세요

コンテンツのためにNotionを検索する
Search Notion for pages containing "{query}" and show me the titles and IDs of the results.
データベースに新しいページを作成する
Create a new page in the {database_name} database with these properties: {property_values}. Use the Notion API to add this page.
フィルターを使用してデータベースをクエリする
Query the {database_name} database and return all items where {filter_condition}. Format the results as a markdown table.
既存のコンテンツを更新する
Update the Notion page with ID {page_id} by adding a new section with the heading "{heading}" and content "{content}".

모범 사례

  • 他のAPI呼び出しを行う前に.botユーザーエンドポイントで認証をテストして、常に確認してください
  • 429レートリミット応答を受信した場合は、即座に再試行するのではなく、指数バックオフを実装してください
  • 削除やアーカイブなど、破壊的な操作の前には常にユーザーの確認を取ってください

피하기

  • ログ、エラーメッセージ、応答でAPIトークンを公開しないでください - Authorizationヘッダーでのみ使用してください
  • レートリミットを処理せずにリクエストを行うことは避けてください - 操作が失敗します
  • 一括操作やデータベースのスキーマ変更に対してユーザーの確認をスキップしないでください

자주 묻는 질문

このスキルの使い方は?
NOTION_API_TOKEN環境変数にNotion統合トークンを設定してください。スキルは自動的にこれを認証に使用します。欠落している場合は、トークンの入力を求めます。
任意のNotionワークスペースでこのスキルを使用できますか?
いいえ。Notion統合はワークスペースに接続され、アクセス하려는ページとデータベースに対して適切な権限を持っている必要があります。Notionで特定のページを統合と共有してください。
レートリミットを超えた場合はどうなりますか?
Notion APIは、レートリミット時にHTTP 429を返します。スキルは指数バックオフの実装と応答のRetry-Afterヘッダーの尊重をお勧めします。
ネストされたページやブロックを作成できますか?
はい。スキルは子ブロックとネストされたページ構造の作成をサポートしています。ただし、いくつかのブロックタイプには子を持つことができません поэтому、ブロックタイプのドキュメントで制限を確認してください。
認証エラーの処理方法は?
NOTION_API_TOKENが有効で期限切れでないことを確認してください。統合がアクセスしようとしている特定のワークスペースとページと共有されていることを確認してください。
このスキルはどのNotion APIバージョンを使用しますか?
このスキルはNotion APIバージョン2025-09-03を使用します。これはすべてのAPIリクエストヘッダーに指定されています。これにより、最新のNotion API機能との互換性が確保されます。

개발자 세부 정보