xuiltul

notion-tool

Notion 연동 도구. 페이지·데이터베이스 검색·조회·생성·갱신을 API로 수행한다. Use when: Notion 페이지 편집, 데이터베이스 행 추가, 워크스페이스 검색이 필요할 때.

xuiltul 254 45 Updated 5mo ago
GitHub

Install

npx skillscat add xuiltul/animaworks/templates-ko-common-skills-notion-tool

Install via the SkillsCat registry.

SKILL.md

Notion 도구

Notion API를 통해 페이지 및 데이터베이스를 검색, 조회, 생성, 업데이트하는 외부 도구입니다.

호출 방법

Bash: animaworks-tool notion <서브커맨드> [인수]로 실행합니다.

액션 목록

search — 워크스페이스 검색

animaworks-tool notion search [검색어] -j

get_page — 페이지 메타데이터 조회

animaworks-tool notion get-page PAGE_ID -j

get_page_content — 페이지 본문 조회

animaworks-tool notion get-page-content PAGE_ID -j

get_database — 데이터베이스 메타데이터 조회

animaworks-tool notion get-database DATABASE_ID -j

query — 데이터베이스 쿼리

animaworks-tool notion query DATABASE_ID [--filter JSON] [--sorts JSON] [-n 10] -j
  • filter: Notion API 필터 JSON (선택)
  • sorts: 정렬 조건 배열 (선택)

create_page — 페이지 생성

animaworks-tool notion create-page --parent-page-id ID --properties JSON -j
  • parent_page_id 또는 parent_database_id 중 하나가 필수
  • children: 페이지 본문 블록 배열 (선택)

update_page — 페이지 업데이트

animaworks-tool notion update-page PAGE_ID --properties JSON -j

create_database — 데이터베이스 생성

animaworks-tool notion create-database --parent-page-id ID --title "이름" --properties JSON -j

CLI 사용법

animaworks-tool notion search [검색어] -j
animaworks-tool notion get-page PAGE_ID -j
animaworks-tool notion get-page-content PAGE_ID -j
animaworks-tool notion get-database DATABASE_ID -j
animaworks-tool notion query DATABASE_ID [--filter JSON] [--sorts JSON] [-n 10] -j
animaworks-tool notion create-page --parent-page-id ID --properties JSON -j
animaworks-tool notion update-page PAGE_ID --properties JSON -j
animaworks-tool notion create-database --parent-page-id ID --title "이름" --properties JSON -j

주의사항

  • Notion API Token이 credentials에 사전 설정되어 있어야 합니다
  • 페이지/데이터베이스 ID는 하이픈 있는 형식과 없는 형식 모두 가능합니다
  • properties 구조는 Notion API 스키마를 따릅니다