Linkly CLI
Linkly CLI는 터미널에서 Linkly 계정을 관리하기 위한 명령줄 도구입니다. 짧은 링크를 생성하고, 클릭 분석을 가져오고, 커스텀 도메인을 관리하고, 웹훅을 처리하고, 데이터를 내보낼 수 있습니다 — 셸을 떠나거나 API 코드를 작성할 필요 없이.
이것은 Linkly API를 기반으로 하며 macOS, Linux 및 Windows에서 실행됩니다.
설치
CLI에는 Node.js 20 이상이 필요합니다. npm으로 전역적으로 설치합니다:
npm install -g @linkly-link-shortener/cli
이는 시스템에 linkly 명령을 추가합니다. 작동하는지 확인합니다:
linkly --help
로그인
CLI는 두 가지 로그인 방법을 지원합니다. 이것을 한 번만 수행하면 되며, 자격 증명은 머신에 안전하게 저장되고 모든 실행에서 재사용됩니다.
API 키로 로그인하려면 다음을 실행합니다:
linkly auth login --api-key
API 키를 붙여넣으라는 메시지가 표시되며, 이는 Linkly 계정 설정에서 찾을 수 있습니다.
대신 OAuth로 로그인하려면 다음을 실행합니다:
linkly auth login
이것은 브라우저를 열어 액세스를 승인할 수 있게 합니다 — 복사할 API 키가 없습니다.
언제든지 상태를 확인하거나 로그아웃할 수 있습니다:
linkly auth status
linkly auth logout
링크 생성 및 관리
짧은 링크를 생성, 검색, 검사, 업데이트 및 삭제합니다:
linkly links create --url https://example.com --name "Spring promo"
linkly links list --search promo
linkly links get 12345
linkly links update 12345 --url https://example.com/new
linkly links delete 12345
클릭 분석
국가, 브라우저, 플랫폼 등으로 그룹화된 클릭 총계를 보거나 날짜 범위에 걸친 시계열로 봅니다:
linkly analytics by country
linkly analytics timeseries --start 2026-01-01 --end 2026-01-31
커스텀 도메인
커스텀 도메인을 나열하거나 새로운 도메인을 추가합니다:
linkly domains list
linkly domains create links.example.com
QR 코드 및 데이터 내보내기
링크의 QR 코드를 다운로드하거나 링크 및 클릭 데이터를 CSV 또는 JSON으로 내보냅니다:
linkly links qr 12345 --output qr.png
linkly links export --format csv --output links.csv
linkly analytics export --format csv --output clicks.csv
웹훅
URL을 구독하여 단일 링크 또는 전체 워크스페이스에 대한 실시간 클릭 이벤트를 받습니다:
linkly webhooks add https://example.com/hook --link 12345
여러 워크스페이스 작업
계정에 둘 이상의 워크스페이스가 있는 경우 기본값을 설정합니다:
linkly workspaces list
linkly workspaces use 42
--workspace 옵션으로 단일 명령에 대해 특정 워크스페이스를 대상으로 지정할 수도 있습니다.
스크립트용 JSON 출력
--json을 모든 명령에 추가하여 형식이 지정된 테이블 대신 원본 API 응답을 얻으면 jq와 같은 도구로 파이핑하기에 좋습니다:
linkly links list --json
도움말 얻기
모든 명령에는 내장 도움말이 있습니다. 개요는 linkly --help를 실행하거나, 옵션과 예제를 보려면 모든 명령에 --help를 추가합니다:
linkly links create --help
AI 에이전트와 함께 CLI 사용
셸 명령을 실행할 수 있는 코딩 어시스턴트(예: Claude Code 또는 Cursor)는 Linkly CLI를 직접 제어할 수 있습니다.
--json을 모든 명령에 추가하여 형식이 지정된 테이블 대신 원본 API 응답을 얻습니다.linkly schema를 실행하여 전체 명령 트리(모든 명령, 인수 및 옵션)를 JSON으로 인쇄하면 어시스턴트가 CLI가 할 수 있는 작업을 검색할 수 있습니다.- 옵션과 예제를 보려면 모든 명령에
--help를 추가합니다.
AI 어시스턴트가 셸 명령을 실행할 수 없는 경우 Linkly MCP Server를 대신 사용합니다 — 이는 Claude 및 ChatGPT와 같은 어시스턴트를 Linkly 계정에 직접 연결합니다.
관련 문서
월 500회 클릭 추적 무료.