개인 개발자 intellectronica가 작성한 Notion 스킬: MCP를 거치지 않고 에이전트가 curl과 jq를 사용해 Notion REST API를 직접 호출하여 콘텐츠 검색, 페이지 및 블록 읽기/쓰기, 데이터베이스와 데이터 소스 쿼리 및 생성, 댓글 읽기/쓰기를 수행합니다. SKILL.md에는 각 엔드포인트에 대한 요청 예시가 포함되어 있습니다.
skills.sh 설치 횟수 98110(+518 / 24시간)
보안 감사: 미감사
- 아직 스캔되지 않음
이유
- 자격 증명 처리 명확화: 먼저 환경 변수 NOTION_API_TOKEN을 찾고, 그다음 사용자가 대화에서 제공한 토큰을 사용하며, 둘 다 없으면 사용자에게 문의합니다. 토큰은 Authorization 요청 헤더에만 포함하고 표시하거나 로그에 기록하지 않도록 요구합니다.
- 변경 전 확인: 페이지 또는 블록 업데이트, 아카이브/삭제, 데이터베이스 구조 변경, 대량 페이지 생성 시에는 먼저 사용자에게 확인을 구하며, 관련 작업 그룹당 한 번 확인합니다.
- Notion-Version 2025-09-03 기준으로 작성되어 새로운 데이터 소스(data source) 인터페이스를 지원합니다. 페이징 방법, 429 속도 제한 백오프 및 요청 크기 상한에 대한 안내가 포함되어 있습니다.
- 저장소는 CC0 라이선스를 따릅니다. skills.sh에서 최근 24시간 동안 설치 횟수가 518회이며 누적 설치 횟수는 98110회입니다. 최근 8주 동안 주간 설치 횟수가 2335회에서 5232회로 증가했습니다(이는 관심도를 나타냅니다).
사용법
- 설치 명령어는 감사 통과 후 표시됩니다. 에이전트에게 “Notion 페이지 읽기/수정” 또는 “Notion 데이터베이스 쿼리”를 지시할 때 트리거됩니다.
- Notion 통합용 API 토큰(환경 변수 NOTION_API_TOKEN으로 설정)이 필요하며, 로컬 머신에는 curl과 jq가 설치되어 있어야 합니다.
위험 요소
- 이번 주에는 감사되지 않았으므로 고정 C 등급이며 설치 명령어가 표시되지 않습니다. SKILL.md는 에이전트가 api.notion.com에 접근하기 위해 curl을 실행하고 NOTION_API_TOKEN을 읽도록 지시하는데, 이는 용도와 일치합니다. skills.sh에서 Gen Agent Trust Hub의 감사 결과는 Pass입니다.
- Notion 공식 제품이 아닙니다. 토큰을 대화에 붙여넣으면 대화 기록에 남으므로 환경 변수를 사용하는 것이 더 안전합니다.
- 에이전트에게 페이지 아카이브 및 블록 삭제 권한이 있으며, 사전 확인은 에이전트의 준수 여부에 달려 있습니다. Notion API 버전이 업데이트되면 예제가 최신 상태가 아닐 수 있습니다.