ntn은 Notion Workers를 관리하고 Notion API에 직접 접근하기 위한 command-line interface (CLI) 도구입니다.

이 도구는 curl -fsSL https://ntn.dev | bash 명령어를 통해 설치할 수 있으며, ntn --version으로 설치를 확인할 수 있습니다. 사용을 시작하려면 ntn login 명령어를 통해 CLI를 사용자의 Notion workspace에 연결하여 authentication을 수행해야 합니다.

ntn CLI가 제공하는 주요 기능은 다음과 같습니다:

1. Notion Workers 관리: Notion Workers는 Notion의 기능을 확장하는 소규모 TypeScript 프로그램으로, sync, tool, webhook과 같은 기능을 구현할 수 있습니다. ntn workers new로 새로운 Worker를 생성하고, ntn workers deploy로 배포하며, ntn workers list로 배포된 Worker 목록을 확인할 수 있습니다. Workers는 Notion과의 통합 및 자동화를 위한 핵심 구성 요소입니다.
2. Notion API 요청: terminal에서 Notion API에 직접 인증된 요청을 보낼 수 있습니다. 이 기능은 inline JSON construction과 shell completion을 지원하여 API 호출을 용이하게 합니다. 예를 들어, ntn api v1/users는 사용자 목록을 조회하고, $ntn api v1/pages parent[page_id]=abc123$은 특정 페이지를 부모로 하는 페이지를 생성하며, $ntn api v1/pages/abc123 -X PATCH archived:= true$는 특정 페이지의 archived 속성을 true로 변경하는 PATCH 요청을 보낼 수 있습니다.
3. 파일 업로드: 이미지나 PDF와 같은 static assets을 Notion에 업로드하여 Notion 페이지에서 참조할 수 있도록 합니다. ntn files create photo.png와 같이 로컬 파일을 업로드하거나, ntn files create --external-url https://example.com/photo.png와 같이 외부 URL에 있는 파일을 Notion으로 가져올 수 있습니다. ntn files list로 업로드된 파일 목록을 확인할 수 있습니다.
4. 데이터 소스 관리: terminal에서 Notion data sources를 생성, 조회 및 관리하는 기능도 제공합니다.

이 도구는 Notion 생태계 내에서 개발 및 자동화 작업을 수행하는 개발자들에게 Notion API와의 직접적이고 효율적인 상호작용 방법을 제공합니다.