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 с AI-агентами

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

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

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