ClipnoClipno

터미널에서 링크를 Notion에 저장하기 — Clipno CLI 출시

업데이트

clipno는 커맨드라인 도구이자 Claude 스킬입니다. 브라우저를 열지 않고도 어떤 링크든 Notion에 저장하거나, 페이지를 구조화된 데이터로 추출할 수 있습니다. cron 작업에 넣거나, 다른 도구로 파이프하거나, Claude에게 링크를 저장해 달라고 말하기만 하면 대신 CLI를 실행해 줍니다.

clipno CLI: clipno save는 링크를 Notion에 기록하고, clipno extract는 구조화된 JSON을 반환하며, Claude 스킬은 채팅에서 둘 다 실행합니다.

핵심 답변

npm i -g clipno로 CLI를 설치하고(Node 18 이상 필요), clipno login을 실행해 Notion 워크스페이스를 연결하세요. 그다음 clipno save <url>는 어떤 링크든 Notion에 저장하고 새 페이지의 URL을 출력하며, clipno extract <url>는 제목·저자·태그·본문 등을 구조화된 JSON으로 반환합니다. Claude 안에서 끝내고 싶다면 npx skills add EwingYangs/clipno-cli로 스킬을 설치하고 “이 링크 Notion에 저장해줘” 또는 “이 링크 해석해줘”라고 말하면 Claude가 대신 CLI를 실행합니다.

사용하는 두 가지 방법: 터미널, 또는 Claude 스킬

CLI는 독립된 npm 패키지로, Node가 설치된 어디서든 동작합니다. cron 작업, CI 파이프라인, 셸 스크립트에 넣거나 다른 명령과 파이프로 연결할 수 있는 평범한 커맨드라인 도구입니다.

Claude 스킬은 같은 기능의 또 다른 입구입니다. npx skills add EwingYangs/clipno-cli로 설치해 두면, 어떤 Claude 세션에서도 “Notion에 저장해줘”, “이 링크 클립해줘”, “이 링크 해석해줘”라고 말하는 것만으로 뒤에서 같은 CLI가 호출됩니다. 터미널과 Claude 안에서 동작이 동일합니다.

extract가 주는 건 구조화된 데이터, 그냥 링크가 아닙니다

clipno extract <url>는 제목, 저자, 이미지, favicon, 발행일, 태그, 출처, 리소스 타입, 그리고 본문 전체를 Markdown으로 반환합니다. 본문만 필요하면 --markdown을 붙여 기사 Markdown만 출력할 수 있습니다.

X/Twitter, YouTube, Reddit, GitHub, WeChat, LinkedIn은 전용 추출기를 통해 더 깔끔한 구조화 데이터를 얻고, 그 외 페이지는 범용 폴백 파이프라인을 거칩니다. extract의 JSON을 스크립트로 바로 파이프하거나, 다른 도구에 넘기거나, AI 에이전트가 저장 여부를 결정하기 전에 링크 내용을 먼저 확인하게 할 수 있습니다.

clipno를 설치하고 첫 링크를 저장하기

설정은 약 1분: 설치하고 한 번 로그인하면, 이후로는 어떤 터미널에서든 save나 extract를 쓸 수 있습니다.

  1. 1

    CLI 설치

    npm i -g clipno로 전역 설치하거나, 설치 없이 npx clipno로 바로 실행하세요. Node.js 18 이상이 필요합니다. clipno는 오픈소스입니다 — 코드는 GitHub에, 패키지는 npm에 있습니다.

    npm i -g clipno
  2. 2

    로그인하고 Notion 연결

    clipno login을 실행하면 브라우저가 열려 clipno.app에서 인증하고, 개인 액세스 토큰이 로컬의 ~/.config/clipno/config.json에 저장됩니다. clipno whoami로 언제든 연결 상태를 확인하고, clipno logout으로 로그아웃할 수 있습니다.

    clipno login
  3. 3

    첫 링크 저장하기

    clipno save <url>를 실행하면 연결된 Notion 데이터베이스에 페이지가 저장되고 새 페이지의 URL이 출력됩니다. --tags "a,b", --note "...", --title "..."를 추가하면 clipno의 자동 감지 대신 직접 태그·메모·제목을 지정할 수 있습니다.

    clipno save https://example.com/article --tags "reading,notion"
    clipno save 실행 후 새 Notion 페이지 URL을 보여주는 터미널 출력
  4. 4

    링크를 구조화된 데이터로 추출하기

    clipno extract <url>를 실행하면 Notion에는 아무것도 저장하지 않고 페이지를 JSON으로 돌려받습니다 — 제목, 저자, 이미지, favicon, 발행일, 태그, 출처, 리소스 타입, 그리고 기사 전체의 Markdown까지. --markdown을 붙이면 기사 Markdown만 출력됩니다.

    clipno extract https://example.com/article
  5. 5

    Claude에게 맡기기

    npx skills add EwingYangs/clipno-cli로 스킬을 설치하면, 어떤 Claude 세션에서든 “이 링크 Notion에 저장해줘” 또는 “이 링크 해석해줘”라고 말하기만 하면 됩니다 — Claude가 대신 CLI를 실행하고 결과를 보여줍니다.

    npx skills add EwingYangs/clipno-cli
    Claude 세션에서 링크에 clipno extract를 실행해 구조화된 제목·저자·출처·태그·본문을 보여주는 모습

팁과 흔한 함정

  • 브라우저 없는 환경이나 CI에서 실행한다면. clipno login --token <clipno_pat_...>CLIPNO_TOKEN 환경 변수를 설정하면 브라우저 인증 과정을 건너뛸 수 있습니다 — cron 작업이나 파이프라인에 유용합니다.
  • 스크립트로 쓴다면 --json을 붙이세요. clipno save <url> --json은 요약 문구 대신 기계가 읽을 수 있는 출력을 반환하므로 jq나 다른 스크립트로 바로 파이프할 수 있습니다.
  • 토큰은 언제든 취소할 수 있습니다. clipno.app/dashboard/tokens에서 개인 액세스 토큰을 관리하고 취소하세요 — CI 시크릿이 유출됐을 때 유용합니다.
  • 무료 플랜은 월 50회 저장. 매달 초기화되며, VIP/Pro는 이 제한을 없애 저장 횟수가 무제한입니다.
  • extract는 Notion을 건드리지 않습니다. 순수한 파서이므로 JSON을 다른 도구로 파이프하거나, 요약하거나, 실제로 저장하기 전에 링크 안에 뭐가 있는지 먼저 확인할 수 있습니다.

자주 묻는 질문

clipno CLI는 무료인가요?
네. 설치와 사용 모두 무료입니다 — 무료 플랜은 월 50회 저장을 포함합니다. VIP/Pro는 이 제한을 없애 저장이 무제한입니다. extract에는 별도의 한도가 없습니다.
Notion 계정 연결이 필요한가요?
clipno save를 쓰려면 필요합니다 — clipno.app/dashboard/notion에서 한 번 Notion 워크스페이스와 데이터베이스를 연결하면 이후 저장이 그곳에 기록됩니다. clipno extract는 Notion 연결 없이도 동작하며, 페이지를 해석해 결과를 출력할 뿐입니다.
extract에도 Notion이 필요한가요?
아니요. extract는 순수한 파서입니다. URL을 가져와 제목, 저자, 태그, 본문 등을 구조화된 JSON으로 반환합니다(--markdown이면 본문 Markdown만). Notion을 연결한 적이 없어도 사용할 수 있습니다.
어떤 사이트가 잘 되나요?
공개된 URL이라면 범용 폴백 파이프라인으로 모두 동작하지만, X/Twitter, YouTube, Reddit, GitHub, WeChat, LinkedIn은 전용 추출기를 통해 더 깔끔한 구조화 데이터를 얻습니다.
오픈소스인가요?
네. CLI와 스킬 모두 <a href="https://github.com/EwingYangs/clipno-cli" target="_blank" rel="noopener noreferrer">GitHub</a>에 오픈소스로 공개되어 있습니다 — 코드를 읽거나, 이슈를 남기거나, 기여할 수 있습니다.

터미널을 떠나지 않고 링크를 Notion에 저장하세요

npm에서 clipno를 무료로 설치하고 1분 안에 Notion 워크스페이스를 연결하세요 — 클릭 한 번으로 클립하고 싶다면 Clipno 브라우저 확장 프로그램도 있습니다. 코드는 GitHub에 오픈소스로 공개되어 있습니다.