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

Использование CLI с агентами ИИ

Помощники по написанию кода, которые могут выполнять команды оболочки — например, Claude Code или Cursor — могут управлять Linkly CLI напрямую.

• Добавьте --json к любой команде, чтобы получить необработанный ответ API вместо форматированной таблицы.
• Выполните linkly schema, чтобы вывести полное дерево команд — каждую команду, аргумент и параметр — в формате JSON, чтобы помощник мог узнать возможности CLI.
• Добавьте --help к любой команде, чтобы увидеть её параметры и примеры.

Если ваш ИИ-помощник не может выполнять команды оболочки, используйте Linkly MCP Server — он подключает таких помощников, как Claude и ChatGPT, к вашему аккаунту Linkly напрямую.