CLI 및 Claude 스킬

clipno는 오픈소스 커맨드라인 도구입니다. 어떤 링크든 Notion에 저장하거나, 어떤 URL이든 구조화된 데이터로 추출할 수 있습니다. 터미널에서는 물론, 스킬을 통해 Claude 세션 안에서도 사용할 수 있습니다.

• 소스코드: github.com/EwingYangs/clipno-cli
• npm 패키지: npmjs.com/package/clipno
• Node.js 18 이상이 필요합니다.

설치

npm i -g clipno

설치하지 않고 npx로 바로 실행할 수도 있습니다.

npx clipno --help

로그인

clipno login

브라우저가 열리고 clipno.app에서 인증을 완료하면, 액세스 토큰이 ~/.config/clipno/config.json에 저장됩니다.

브라우저를 열 수 없는 CI 환경 등에서는 다음과 같이 인증을 건너뛸 수 있습니다.

clipno login --token clipno_pat_xxxxxxxx
# 또는
export CLIPNO_TOKEN=clipno_pat_xxxxxxxx

토큰은 Tokens 페이지에서 언제든지 관리하거나 폐기할 수 있습니다. 저장 기능을 사용하려면 Notion 페이지에서 워크스페이스를 먼저 연결해야 합니다.

링크 저장하기

clipno save https://example.com/article

실행하면 새로 생성된 Notion 페이지의 URL이 출력됩니다. 자주 쓰는 옵션:

clipno save https://example.com/article --tags "읽을거리,AI" --note "나중에 다시 볼 것"
clipno save https://example.com/article --title "직접 지정한 제목"
clipno save https://example.com/article --json

링크 추출하기

clipno extract https://example.com/article

제목, 작성자, 태그, 출처, contentMarkdown, 이미지, 동영상 등을 포함한 구조화된 JSON을 반환합니다. 본문 마크다운만 필요하다면:

clipno extract https://example.com/article --markdown

extract는 페이지를 파싱만 하므로 Notion 연결이 필요 없습니다.

Claude 안에서 사용하기

동일한 도구가 Claude 스킬로도 제공되어, Claude 대화 안에서 바로 링크를 저장하거나 추출할 수 있습니다.

npx skills add EwingYangs/clipno-cli

설치 후에는 Claude 세션에서 "이 링크를 Notion에 저장해줘", "이 링크를 추출해줘"라고 말하기만 하면 스킬이 CLI를 대신 실행해줍니다.

기타 명령어

clipno whoami   # 현재 로그인 상태 확인
clipno logout   # 저장된 토큰 삭제

무료 플랜

무료 플랜은 월 50회 저장이 가능합니다. 더 자세한 튜토리얼은 블로그 글을 참고하세요: 터미널에서 Notion으로 링크 저장하기.