joplin-cli은(는) 무엇을 하나요?
Web Clipper API를 통해 Joplin 데스크톱을 CLI 및 Python SDK로 제어하여 자동화된 노트 관리와 에이전트 기반 워크플로를 구현합니다.
개요
이 스킬은 Joplin 데스크톱 애플리케이션과 통신하여 노트, 태그, 노트북 등을 프로그래밍 방식으로 관리할 수 있게 해줍니다. Web Clipper API를 기반으로 하며, CLI 명령어와 Python SDK를 모두 지원합니다.
주요 기능
- 노트 생성 및 편집: 새 노트를 만들거나 기존 노트를 수정합니다.
- 노트 검색: 키워드나 태그를 기반으로 노트를 검색합니다.
- 노트북 및 태그 관리: 노트북(폴더)과 태그를 생성, 삭제, 이동합니다.
- 리소스 관리: 이미지, 첨부 파일 등의 리소스를 업로드하고 관리합니다.
설치
CLI 사용
pip install joplin-cli
Python SDK 사용
pip install joplin-api
설정
Joplin 데스크톱에서 Web Clipper 서비스를 활성화해야 합니다:
- Joplin → 설정 → Web Clipper →
Web Clipper 서비스 활성화 - API 토큰을 복사합니다.
- 환경 변수나 설정 파일에 토큰을 설정합니다.
export JOPLIN_API_TOKEN="your_token_here"
export JOPLIN_API_URL="http://localhost:41184"
사용 예제
CLI
# 새 노트 만들기
joplin note create --title "내 노트" --body "노트 내용"
# 특정 태그가 있는 노트 검색
joplin search --query "태그:중요"
# 노트북 목록 보기
joplin notebook list
Python SDK
from joplin_api import JoplinApi
joplin = JoplinApi(token="your_token", port=41184)
# 모든 노트 가져오기
notes = joplin.get_notes()
# 새 노트 만들기
joplin.create_note(
title="API로 만든 노트",
body="API를 통해 생성된 노트입니다.",
notebook_id="your_notebook_id"
)
지원 플랫폼
- AI 에이전트: Claude Code, Cursor, Codex 등
- 운영체제: Windows, macOS, Linux (Joplin이 실행되는 모든 플랫폼)
문서 및 참고 자료
라이선스
MIT