Linkly CLI

Linkly CLI là một công cụ dòng lệnh để quản lý tài khoản Linkly của bạn từ terminal. Tạo liên kết ngắn, kéo phân tích nhấp chuột, quản lý tên miền tùy chỉnh, xử lý webhook và xuất dữ liệu — mà không cần rời khỏi shell hoặc viết bất kỳ mã API nào.

Nó được xây dựng trên Linkly API và chạy trên macOS, Linux và Windows.

Cài đặt

CLI yêu cầu Node.js 20 hoặc mới hơn. Cài đặt nó toàn cầu với npm:

npm install -g @linkly-link-shortener/cli

Điều này thêm lệnh linkly vào hệ thống của bạn. Xác nhận nó hoạt động:

linkly --help

Đăng nhập

CLI hỗ trợ hai cách để đăng nhập. Bạn chỉ cần làm điều này một lần — thông tin xác thực của bạn được lưu một cách an toàn trên máy của bạn và sử dụng lại trên mỗi lần chạy.

Để đăng nhập bằng khóa API, chạy:

linkly auth login --api-key

Bạn sẽ được yêu cầu dán khóa API của bạn, mà bạn có thể tìm thấy trong cài đặt tài khoản Linkly của bạn.

Để đăng nhập bằng OAuth, chạy:

linkly auth login

Điều này mở trình duyệt của bạn để bạn có thể phê duyệt quyền truy cập — không có khóa API nào để sao chép.

Kiểm tra trạng thái của bạn hoặc đăng xuất bất kỳ lúc nào:

linkly auth status

linkly auth logout

Tạo và quản lý liên kết

Tạo, tìm kiếm, kiểm tra, cập nhật và xóa liên kết ngắn:

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

Phân tích nhấp chuột

Xem tổng nhấp chuột được nhóm theo quốc gia, trình duyệt, nền tảng, v.v. — hoặc dưới dạng chuỗi thời gian trong phạm vi ngày:

linkly analytics by country

linkly analytics timeseries --start 2026-01-01 --end 2026-01-31

Tên miền tùy chỉnh

Liệt kê tên miền tùy chỉnh của bạn hoặc thêm một tên miền mới:

linkly domains list

linkly domains create links.example.com

Mã QR và xuất dữ liệu

Tải xuống mã QR của liên kết hoặc xuất liên kết và dữ liệu nhấp chuột của bạn dưới dạng CSV hoặc JSON:

linkly links qr 12345 --output qr.png

linkly links export --format csv --output links.csv

linkly analytics export --format csv --output clicks.csv

Webhooks

Đăng ký một URL để nhận sự kiện nhấp chuột theo thời gian thực cho một liên kết duy nhất hoặc toàn bộ không gian làm việc:

linkly webhooks add https://example.com/hook --link 12345

Làm việc với nhiều không gian làm việc

Nếu tài khoản của bạn có nhiều hơn một không gian làm việc, hãy đặt mặc định:

linkly workspaces list

linkly workspaces use 42

Bạn cũng có thể nhắm mục tiêu một không gian làm việc cụ thể cho một lệnh duy nhất với tùy chọn --workspace.

Đầu ra JSON cho các tập lệnh

Thêm --json vào bất kỳ lệnh nào để nhận phản hồi API thô thay vì bảng được định dạng — rất hữu ích để piping vào các công cụ như jq:

linkly links list --json

Nhận trợ giúp

Mỗi lệnh đều có trợ giúp tích hợp sẵn. Chạy linkly --help để xem tổng quan hoặc thêm --help vào bất kỳ lệnh nào để xem các tùy chọn và ví dụ của nó:

linkly links create --help

Sử dụng CLI với các agent AI

Các trợ lý mã có thể chạy lệnh shell — chẳng hạn như Claude Code hoặc Cursor — có thể điều khiển Linkly CLI trực tiếp.

• Thêm --json vào bất kỳ lệnh nào để nhận phản hồi API thô thay vì bảng được định dạng.
• Chạy linkly schema để in toàn bộ cây lệnh — mỗi lệnh, đối số và tùy chọn — dưới dạng JSON, để một trợ lý có thể khám phá những gì CLI có thể làm.
• Thêm --help vào bất kỳ lệnh nào để xem các tùy chọn và ví dụ của nó.

Nếu trợ lý AI của bạn không thể chạy lệnh shell, hãy sử dụng Linkly MCP Server thay thế — nó kết nối các trợ lý như Claude và ChatGPT trực tiếp với tài khoản Linkly của bạn.