linktw.in/desk-tour
REST API
npm i -g @linktwin/cli
LinkTwin CLI: 명령줄에서 링크를 단축하고 관리하세요.
LinkTwin CLI는 단축 링크와 딥링크를 터미널로 가져옵니다. 링크를 생성, 수정, 분석하고, QR 코드, 컬렉션, 도메인, 픽셀을 관리하며, 간단한 명령과 JSON 출력으로 이 모든 것을 자동화하세요. 개발자, 스크립트, CI를 위해 만들었습니다.
npm install -g @linktwin/cli
- Node.js 18 이상
- MIT 라이선스, npm에서 제공
- --json으로 스크립트 작성 가능
실제 명령과 출력 형식을 보여 주는 예시 세션.
개발자를 위해 만들어짐
링크 하나 단축하려고 화면을 오가지 마세요.
당신은 터미널에서 살아갑니다. 링크를 만들려고 대시보드를 열거나 간단한 스크립트를 위해 API 호출을 직접 작성하면 속도가 느려집니다. LinkTwin CLI는 링크 생성, 딥링킹, 분석을 명령어 하나 거리에 둡니다.
완료까지의 단계
- 대시보드
- LinkTwin CLI
별칭으로 링크 단축
가장 많이 클릭된 링크 목록
작업
기존 방식
LinkTwin CLI 사용 시
링크 만들기
대시보드를 쓰려고 터미널을 떠나야 함
linktwin links create <url>
로그인
스크립트마다 curl + 인증을 작성
한 번 로그인하면, 이후엔 명령어만
일괄 작업
간편한 대량 작업 불가
간편한 대량 생성 및 삭제
자동화
CI에 연동하기 어려움
--json + 환경 변수 = CI 준비 완료
시작하기
명령어 두 개로 바로 시작
Node.js 18 이상이 필요합니다. API 키는 ~/.linktwin/config.json에 로컬로 저장됩니다.
# 1. 설치 (Node.js 18 이상)
npm install -g @linktwin/cli
# 2. 인증 (API 키 붙여넣기)
linktwin login
# 3. 첫 링크 만들기
linktwin links create https://example.com --custom helloAI를 사용하시나요? MCP 서버를 사용해 보세요. 직접 연동을 만드시나요? API 문서를 읽어 보세요.
API 키를 가져오는 곳
CLI는 다음 순서로 자격 증명을 찾아 처음 찾은 것을 사용하므로, CI 작업은 저장된 로그인을 건드리지 않고도 이를 덮어쓸 수 있습니다.
- 플래그
--api-key--base-url - 환경 변수
LINKTWIN_API_KEYLINKTWIN_BASE_URL - 저장된 로그인~/.linktwin/config.json, linktwin login이 작성하며 본인만 읽을 수 있습니다 (mode 0600).
- 기본 베이스 URL
https://linktw.in
명령어
명령어 하나로 모든 것을
링크 워크플로의 모든 단계를 위한 전용 명령어. 모든 명령은 전역 옵션 --json, --api-key, --base-url도 사용할 수 있습니다.
linktwin links
단축 링크와 딥링크를 만들고, 나열하고, 조회하고, 업데이트하고, 삭제하고, 대량 삭제하세요.
-
linktwin links create <url>단축 링크 또는 딥링크 만들기
- -c, --custom <alias>
- -p, --password
- -d, --domain
- --expiry
- --clicklimit
- --expiration-redirect
- --note
- --display-title
- --metatitle
- --metadescription
- --metaimage
- --collections
- --pixels
- --data <json>
-
linktwin links list내 링크 목록
- -l, --limit
- --page
- -o, --order
- -s, --search
- --from
- --to
- --collections
-
linktwin links get <id>링크 상세 정보 전체 표시 (ID 또는 단축 URL)
- --timezone
-
linktwin links update <id>링크 업데이트 (ID 또는 단축 URL). 변경된 필드만 전송됩니다.
- --url
- 및 모든 생성 옵션
-
linktwin links delete <id>링크 삭제 (ID 또는 단축 URL)
- -y, --yes
-
linktwin links bulk-delete <ids>쉼표로 구분한 ID로 여러 링크 삭제
- -y, --yes
$ linktwin links list --order clicks_desc --limit 3
ID Short URL Clicks Title Created
──── ───────────────────────────── ────── ──────────────────────────────── ───────────────────
1221 https://linktw.in/desk-tour 1764 My $200 desk setup (full tour) 2026-08-06 21:41:00
1222 https://linktw.in/new-camera 1098 Unboxing my new camera 2026-09-21 18:52:00
1224 https://linktw.in/my-keyboard 570 Amazon: Low profile mechanical … 2026-08-07 10:30:00
Page 1/3 · 9 totallinktwin stats
링크별 및 계정 분석: 클릭, 국가, 추천 소스, 기기, 트렌드.
-
linktwin stats link <id>단일 링크 분석 (ID 또는 단축 URL)
- --timezone
-
linktwin stats dashboard계정 전체 KPI와 클릭 추이
- -p, --period 1d|1w|1m|1y|max
- --timezone
-
linktwin stats detailed세부 분류가 포함된 상세 계정 분석
- -r, --range 1d|7d|30d|max|custom
- --start
- --end
- --collections
- --timezone
-
linktwin stats trend시간별/일별 클릭 분포 (일간 추이)
- -p, --period
- --timezone
$ linktwin stats dashboard --period 1m
Dashboard
Total clicks: 4370
Unique clicks: 3915
Top country: United States
Top referrer: https://l.instagram.com
Total links: 9
Growth %: 64.22linktwin collections
링크를 컬렉션으로 정리하고 대량으로 배정하세요.
-
linktwin collections list컬렉션 목록
- -l, --limit
- --page
-
linktwin collections get <id>컬렉션 내 항목 목록
- -l, --limit
- --page
-
linktwin collections create <name>컬렉션 만들기
- --description
- --color <hex>
- --slug
- --public
- --starred
-
linktwin collections update <id>컬렉션 업데이트
- --name
- --description
- --color
- --public <bool>
- --starred <bool>
-
linktwin collections assign <collectionId> <linkIds>컬렉션에 링크 추가/제거 (쉼표로 구분한 링크 ID)
- --remove
-
linktwin collections delete <id>컬렉션 삭제 (항목은 삭제되지 않고 할당만 해제됨)
- -y, --yes
$ linktwin collections assign 4 1221,1222,1223
✓ Added 3, removed 0 link(s).linktwin domains
브랜드 커스텀 도메인을 추가하고 관리하세요.
-
linktwin domains list사용 가능한 모든 도메인 목록 (기본 + 브랜드)
- -l, --limit
- --page
-
linktwin domains add <domain>브랜드 도메인 추가 (http:// 또는 https:// 포함)
- --redirect-root
- --redirect-404
-
linktwin domains update <id>브랜드 도메인 업데이트
- --redirect-root
- --redirect-404
-
linktwin domains delete <id>브랜드 도메인 삭제
- -y, --yes
$ linktwin domains add https://go.mayamakes.shop --redirect-root https://mayamakes.shop
✓ Added domain https://go.mayamakes.shop (id 12).linktwin pixels
리타겟팅 픽셀을 만들어 링크에 추가하세요.
-
linktwin pixels list리타겟팅 픽셀 목록
- -l, --limit
- --page
-
linktwin pixels get <id>픽셀과 할당된 링크 표시
- -l, --limit
- --page
-
linktwin pixels create리타겟팅 픽셀 만들기
- -t, --type fbpixel|gtmpixel|…
- -n, --name
- --tag
- --event
-
linktwin pixels update <id>픽셀 업데이트
- --tag
- -n, --name
- --event
-
linktwin pixels assign <pixelId> <linkIds>링크에 픽셀 추가/제거 (쉼표로 구분한 링크 ID)
- --remove
-
linktwin pixels delete <id>픽셀 삭제
- -y, --yes
$ linktwin pixels create --type fbpixel --name "Meta pixel" --tag 1234567890
✓ Created pixel Meta pixel (id 4).linktwin qr
모든 링크의 QR 코드를 생성하고 관리하세요.
-
linktwin qr listQR 코드 목록 조회
- -l, --limit
- --page
-
linktwin qr get <id>QR 코드와 스캔 분석 표시
-
linktwin qr createQR 코드 만들기
- -t, --type text|vcard|link|email|phone|sms|wifi
- -d, --data
- --background
- --foreground
- --logo
-
linktwin qr update <id>QR 코드 업데이트
- -d, --data
- --background
- --foreground
- --logo
-
linktwin qr delete <id>QR 코드 삭제
- -y, --yes
$ linktwin qr create --type link --data https://linktw.in/desk-tour
✓ Created QR code https://linktw.in/qr/a58f79 (id 3).계정
키를 한 번만 저장하고, 사용 중인 계정을 확인하고, 자격 증명을 어디서 읽는지 확인하세요.
-
linktwin loginLinkTwin API 키와 베이스 URL 저장
- -k, --key
- -u, --url
- --no-verify
-
linktwin logout저장된 자격 증명 삭제
-
linktwin whoami현재 계정, 플랜, 사용량 표시
-
linktwin config자격 증명을 읽는 위치 표시
$ linktwin whoami
Account
Email: [email protected]
Plan: Large
User ID: 57842
Links used: 9
Clicks: 4370
Base URL: https://linktw.in스크립트, cron 작업, CI를 위해 만들었습니다.
같은 명령이 셸 스크립트, 예약 작업, 빌드 파이프라인에서도 작동합니다. 파싱 가능한 출력을 원하면 --json을 추가하고, 키는 환경 변수로 전달하세요.
- 모든 명령에 --json을 붙이면 원시 API 응답이 출력되어 jq로 바로 처리할 수 있습니다.
- LINKTWIN_API_KEY와 LINKTWIN_BASE_URL이 저장된 로그인보다 우선하므로, CI에서는 linktwin login이 필요 없습니다.
- 삭제 명령은 --yes 없이 실행되지 않으므로, 스크립트가 실수로 링크를 지우는 일이 없습니다.
- 오류가 발생하면 코드 1로 종료되고 stderr에 원인을 출력하므로, 실패한 단계에서 파이프라인이 멈춥니다.
jq
# 클릭 수와 단축 URL로 표시한 가장 많이 클릭된 링크 5개
linktwin links list --order clicks_desc --limit 5 --json \
| jq -r '.data.urls[] | "\(.clicks)\t\(.shorturl)"'
일괄 생성
# urls.txt의 URL마다 단축 링크 하나씩
while read -r url; do
linktwin links create "$url" --json | jq -r '.shorturl'
done < urls.txt
타겟팅
# JSON으로 전달하는 지역 타겟팅 및 UTM 파라미터
linktwin links create https://example.com --custom promo \
--data '{"geotarget":[{"location":"Canada","link":"https://example.ca"}],
"parameters":[{"name":"utm_source","value":"newsletter"}]}'
GitHub Actions
# 워크플로 단계: 릴리스마다 단축 링크 생성
- name: Short link for the release notes
env:
LINKTWIN_API_KEY: ${{ secrets.LINKTWIN_API_KEY }}
run: |
npm install -g @linktwin/cli
linktwin links create "https://example.com/releases/${{ github.ref_name }}" --jsonCLI 관련 질문
LinkTwin 명령줄 도구에 관한 모든 것. 아직 궁금한 점이 있으신가요? 문의하세요.
LinkTwin CLI란 무엇인가요?
LinkTwin CLI는 터미널에서 링크를 단축하고 관리하는 명령줄 도구(linktwin 명령)입니다. 대시보드를 열지 않고도 단축 링크와 딥링크를 만들고, 컬렉션, 브랜드 도메인, 리타겟팅 픽셀, QR 코드를 관리하고, 클릭 분석을 가져올 수 있습니다. 모든 명령은 스크립팅과 자동화를 위한 --json 출력을 지원합니다.
LinkTwin CLI는 어떻게 설치하나요?
npm install -g @linktwin/cli로 npm에서 설치하세요. Node.js 18 이상이 필요합니다. 그런 다음 linktwin login을 실행하고 API 키를 붙여넣으면 명령줄에서 링크를 만들 준비가 끝납니다.
URL 단축기 CLI는 무료인가요?
CLI 자체는 무료이며 MIT 라이선스입니다. LinkTwin API를 통해 작동하며, API 액세스는 모든 플랜에서 이용할 수 있습니다. 먼저 무료 계정을 만들고 API가 필요할 때 업그레이드하세요.
스크립트와 CI에서 CLI를 사용할 수 있나요?
네. 어떤 명령이든 --json을 붙이면 jq로 파이프할 수 있는 기계 판독용 출력을 얻을 수 있고, LINKTWIN_API_KEY 환경 변수를 설정하면 프롬프트 없이 인증됩니다. 그래서 CLI는 빌드 파이프라인, cron 작업, 대량 링크 생성에 잘 맞습니다.
CLI로 단축 링크뿐 아니라 딥링크도 만들 수 있나요?
네. 만드는 모든 링크는 휴대폰에서 YouTube, Amazon, Spotify 같은 알맞은 앱에서 열립니다. CLI로 지역, 기기, 언어 타겟팅, A/B 테스팅, UTM 파라미터, 브랜드 도메인도 설정할 수 있습니다. 고급 타겟팅은 --data 플래그로 JSON을 전달하세요.
API 키는 어디서 받나요?
LinkTwin에 로그인한 뒤 대시보드에서 설정을 열거나, 도구 및 연동에서 CLI 도구를 여세요. API 키를 복사해 linktwin login을 실행하거나 LINKTWIN_API_KEY 환경 변수로 설정하세요. 플랜에 API 액세스가 포함되어 있으면 키가 표시됩니다.
LinkTwin CLI에는 어떤 명령이 있나요?
자격 증명용 login, logout, whoami, config와 6개의 명령 그룹: links, stats, collections, domains, pixels, qr. linktwin 뒤에 명령과 --help를 붙여 실행하면 모든 옵션을 볼 수 있습니다.
명령에서 링크를 어떻게 지정하나요?
숫자 ID나 단축 URL을 사용하세요. 예: linktwin stats link linktw.in/desk-tour. 단축 URL은 https:// 유무와 관계없이 작동합니다. 둘 다 linktwin links list 출력에서 찾을 수 있습니다.
터미널을 벗어나지 않고 다음 링크를 단축하세요
LinkTwin CLI를 설치하고 셸에서 링크 관리를 시작하세요.
npm install -g @linktwin/cli
API 액세스는 모든 플랜에서 이용할 수 있습니다. 플랜 보기