Перейти к содержимому
Все статьи

climcpapi

Сокращатель ссылок с CLI для разработчиков и ИИ-агентов

Сокращайте URL из командной строки с Linkdash CLI. Делитесь файлами, проводите A/B-тесты, настраивайте таргетинг и управляйте ссылками через MCP.

Igor Kirnosov9 мин чтения

Терминал создаёт короткую ссылку Linkdash командой linkdash links create

Linkdash — это сокращатель ссылок, которым управляют из терминала. Одна команда превращает URL, файл или фрагмент текста в отслеживаемую короткую ссылку на lida.sh и выводит результат в JSON, который можно передать куда угодно через пайп. Те же операции доступны через HTTP API и как MCP-сервер, поэтому ИИ-агент может создавать, изменять и анализировать ссылки теми же инструментами, что и вы.

В этом руководстве разобран весь CLI: установка, первая короткая ссылка, обмен файлами, защита ссылок, A/B-тесты, маршрутизация посетителей по стране или устройству и чтение аналитики без браузера.

Дашборд Linkdash со списком коротких ссылок: тип, slug, адрес и статус

Установите Linkdash CLI

CLI — это npm-пакет, ему нужен Node.js 20 или новее.

npm i -g linkdash-cli

Так же работают pnpm add -g linkdash-cli и bun add -g linkdash-cli. Устанавливается команда linkdash.

Затем создайте аккаунт и авторизуйте CLI за один шаг:

linkdash auth create

Команда открывает страницу регистрации в браузере. Когда аккаунт создан, вы подтверждаете код, показанный в терминале, и CLI входит в аккаунт. Если аккаунт у вас уже есть, используйте linkdash auth login. linkdash auth whoami показывает, какой аккаунт используется, а в справочнике по CLI перечислены все команды и флаги.

Сеанс хранится в ~/.config/linkdash/config.json с правами доступа только для владельца. Для CI и других окружений без интерфейса задайте LINKDASH_TOKEN — токен сеанса из этого файла на компьютере, где вы вошли, — и обращайтесь с ним как с любым другим секретом.

Сократите URL из командной строки

linkdash links create --url https://example.com/pricing --slug pricing
{
  "id": "pricing",
  "url": "https://lida.sh/pricing",
  "kind": "url",
  "variants": [
    { "name": "main", "kind": "url" }
  ]
}

Вот и весь интерфейс: успешные команды выводят JSON в stdout, а ошибки — обычный текст в stderr с кодом выхода 1. Флага --json нет, потому что JSON — единственный формат вывода. Поэтому CLI легко использовать в скриптах. Например, чтобы сразу скопировать новую короткую ссылку в буфер обмена на macOS:

linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy

Несколько флагов, которые вы будете использовать постоянно:

  • --slug задаёт публичный путь. Slug может содержать строчные латинские буквы, цифры и дефисы внутри, до 64 символов. Если его не указать, Linkdash сгенерирует slug сам.
  • --name — приватная метка, которую видите только вы; она помогает потом находить ссылки.
  • --tag можно повторять: --tag launch --tag q4 добавит ссылке два тега.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term и --utm-content добавляют параметры кампании к адресу назначения.

Найти созданное можно командой linkdash links list --q pricing --tag launch.

Поделитесь файлом или фрагментом текста

Короткие ссылки — не только для URL. Та же команда загружает файл или сохраняет фрагмент текста:

linkdash links create --file ./board-deck.pdf --slug board-deck --expires 7d
linkdash links create --text "Release checklist: tag, build, smoke test, announce" --tag launch

Ссылка на файл даёт посетителям скачивание, с превью для изображений и видео. Ссылка на текст показывает фрагмент на странице с кнопкой копирования. Обе отслеживаются как любые другие ссылки, так что вы видите, кто и когда открыл вашу презентацию. Чтобы заменить файл за существующей ссылкой, не меняя URL:

linkdash links update board-deck --file ./board-deck-v2.pdf

Решайте, кто может открыть ссылку

У каждой ссылки могут быть свои правила доступа:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • --password запрашивает у посетителей пароль, прежде чем ссылка откроется.
  • --starts и --expires принимают длительность, например 30m, 24h или 7d, или дату в формате ISO. До времени начала ссылка вообще не открывается.
  • --max-openings приостанавливает ссылку после указанного числа открытий — удобно для одноразовых скачиваний.

Приостановить и возобновить ссылку можно в любой момент: linkdash links update q4-deck --status paused и --status active.

Проведите A/B-тест на короткой ссылке

В Linkdash каждая ссылка — это контейнер для одного или нескольких вариантов. Вариант — это адрес назначения (URL, файл или текст) со своим весом и правилами. У обычной ссылки один вариант с именем main. Добавьте ещё — и короткая ссылка начнёт делить между ними трафик:

linkdash links create --slug launch \
  --variant control --url https://example.com/pricing \
  --variant annual-first --url "https://example.com/pricing?view=annual"

Флаги после каждого --variant относятся к этому варианту до следующего. Трафик делится по весу, который по умолчанию равен 1, так что пример выше — тест 50/50. Задайте варианту --weight 3, чтобы он получал втрое больше трафика.

По умолчанию назначение закреплено: вернувшийся посетитель получает тот же вариант, а это именно то, что нужно для честного теста. Когда вы меняете эксперимент, linkdash links update launch --restart-split один раз заново распределяет всех.

Ссылка Linkdash с двумя вариантами, control и annual-first, делит трафик между двумя страницами с ценами

Статистика возвращается по вариантам, поэтому их можно сразу сравнить:

linkdash links stats launch --last 7d

Массив variants в выводе содержит visits, visitors, downloads и plays для каждого варианта. Подробнее о статистике — ниже.

Направляйте посетителей по стране, устройству или параметру запроса

У вариантов также могут быть условия. Добавьте варианту --when, и получать его смогут только подходящие посетители. Так одна короткая ссылка превращается в маршрутизатор. Например, ссылка, которая отправляет телефоны в нужный магазин приложений:

linkdash links create --slug get-app \
  --variant ios \
    --url https://apps.apple.com/app/example/id000000000 \
    --when os=ios \
  --variant android \
    --url "https://play.google.com/store/apps/details?id=com.example" \
    --when os=android \
  --variant web \
    --url https://example.com/app

Когда посетитель открывает ссылку, пул образуют варианты с подходящими условиями. Если не подходит ни один, используются варианты без условий, поэтому web в примере выше ловит всех, кто не на iOS и не на Android.

Ссылка Linkdash направляет посетителей с iOS в App Store, с Android — в Google Play, а всех остальных — на веб-страницу

Условия можно задавать по:

Ключ Что проверяет Пример
country Коды стран ISO --when country=DE,AT,CH
device mobile, tablet, desktop --when device=mobile
os windows, macos, android, ios, linux, other --when os=ios
browser edge, chrome, firefox, safari, other --when browser=safari
language Языковые теги, по префиксу --when language=de
referrer Хост источника перехода --when referrer=twitter.com

Повторите --when, чтобы потребовать несколько условий одновременно. --when country=DE,AT --when device=mobile подходит для мобильных посетителей из Германии или Австрии.

Варианты могут проверять и строку запроса посетителя, поэтому одна ссылка может вести себя по-разному в зависимости от того, где вы ею поделились. lida.sh/launch?src=newsletter может отправлять читателей рассылки на отдельную страницу:

linkdash links variants add launch --name newsletter \
  --url https://example.com/pricing/newsletter \
  --when param:src=newsletter

Правила для параметров поддерживают «равно» (=), «не равно» (!=), «содержит» (~=), «начинается с» (^=), «заканчивается на» ($=), «одно из» (=a|b), «присутствует» (param:ref?) и «отсутствует» (param:!ref). Если же вы хотите передавать параметры посетителя на адрес назначения, создайте ссылку с --forward-params.

В дашборде есть те же настройки, а страну можно найти по названию, так что не нужно помнить, что Словения — это SI:

Выбор целевых стран для варианта в дашборде Linkdash, выбраны Германия и Австрия

Аналитика кликов в терминале

linkdash links stats launch --last 7d

В выводе есть общее число visits, downloads и plays, число посещений за указанный период (visitsInLast), страны (countries) и источники переходов (referrers), разбивка по вариантам (variants) и список visitors со временем, страной, устройством, браузером и источником перехода для каждого недавнего посещения. --last принимает длительность, например 24h или 30d, по умолчанию — 24h.

Linkdash не хранит IP-адреса посетителей. Адрес используется, чтобы определить страну посетителя и получить анонимный идентификатор посетителя, который меняется каждый день, после чего удаляется.

Чтобы реагировать на клики в момент, когда они происходят, зарегистрируйте вебхук. Linkdash отправляет подписанные события link.visit, link.download и link.play на любой HTTPS-эндпоинт:

linkdash webhooks create --url https://example.com/hooks

Секрет подписи выводится один раз, поэтому сохраните его сразу. О проверке подписей — в документации по вебхукам.

Пусть ИИ-агенты создают короткие ссылки через MCP

Всё описанное выше доступно и ИИ-агентам. Linkdash запускает удалённый MCP-сервер по адресу https://api.linkdash.dev/mcp, и его инструменты повторяют CLI: links_create, links_update, links_stats, variants_add, domains_add и остальные возвращают тот же JSON.

Создайте API-ключ в дашборде в разделе «API-ключи», затем подключите агента. В Claude Code:

claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
  --header "Authorization: Bearer $LINKDASH_API_KEY"

В Cursor добавьте сервер в .cursor/mcp.json:

{
  "mcpServers": {
    "linkdash": {
      "url": "https://api.linkdash.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
    }
  }
}

В Codex, который читает ключ из указанной вами переменной окружения:

codex mcp add linkdash --url https://api.linkdash.dev/mcp \
  --bearer-token-env-var LINKDASH_API_KEY

После этого ссылки можно просить обычным языком, например «сократи https://example.com/pricing как pricing и добавь тег launch» или «какой вариант launch получил больше посетителей на этой неделе?», и агент вызовет нужный инструмент. В документации по MCP описан и OpenCode.

Если ваш агент уже работает в терминале, он может использовать CLI напрямую. Установите навык Linkdash для агентов, чтобы он знал команды и флаги:

npx skills add https://linkdash.dev/skills/linkdash/SKILL.md

Используйте HTTP API

Для вашего собственного кода те же операции доступны как обычный REST API по адресу https://api.linkdash.dev/v1 с аутентификацией тем же API-ключом:

curl https://api.linkdash.dev/v1/links \
  -H "Authorization: Bearer $LINKDASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/pricing", "slug": "pricing" }'

Ответ имеет ту же структуру, что и вывод CLI. В справочнике по API описаны все эндпоинты, включая загрузку файлов и варианты.

Используйте свой домен

По умолчанию короткие ссылки находятся на lida.sh. Чтобы обслуживать их со своего домена, добавьте его и направьте DNS на Linkdash:

linkdash domains add go.example.com
linkdash domains verify go.example.com

Затем создавайте ссылки на нём с --domain go.example.com. У каждого собственного домена свой набор slug, поэтому go.example.com/launch не пересекается ни с чьим другим launch. В руководстве по доменам описана настройка DNS, включая настройку в один клик для провайдеров, которые её поддерживают.

Тарифы

Тарифу Free не нужна банковская карта. Он включает 5 000 событий в месяц, 1 ГБ хранилища для файлов, историю аналитики за один месяц и один собственный домен. Событие — это посещение, скачивание или воспроизведение по одной из ваших ссылок или операция записи, например создание или изменение ссылки. Операции чтения, например вывод списка ссылок или получение статистики, бесплатны.

Платные тарифы повышают эти лимиты: Professional стоит $18 в месяц, Growth — $48 в месяц. Полное сравнение — на странице тарифов.

Частые вопросы

Есть ли бесплатный сокращатель ссылок с CLI?

Да. Linkdash CLI работает на тарифе Free, который включает 5 000 событий в месяц без банковской карты.

Можно ли использовать Linkdash CLI в CI?

Да. Задайте LINKDASH_TOKEN с токеном сеанса, и CLI будет работать без браузера. Поскольку каждая команда выводит JSON, можно создавать и изменять ссылки из GitHub Actions или любого другого пайплайна и читать результаты через jq.

Могут ли ИИ-агенты создавать короткие ссылки?

Да, тремя способами: через MCP-сервер по адресу https://api.linkdash.dev/mcp, через CLI с установленным навыком Linkdash для агентов или через HTTP API. Все три предоставляют одни и те же операции и возвращают одинаковый JSON.

Хранит ли Linkdash IP-адреса посетителей?

Нет. Linkdash использует адрес, чтобы определить страну посетителя и создать ежедневный анонимный идентификатор, после чего удаляет его. Владельцы ссылок никогда не видят IP-адреса.

Может ли одна короткая ссылка отправлять разных посетителей на разные страницы?

Да. Добавьте ссылке несколько вариантов и задайте каждому условия: страну, устройство, операционную систему, язык, источник перехода или параметр запроса. Варианты без условий делят трафик по весу — так и проводится A/B-тест.


Готовы попробовать? Установите CLI, выполните linkdash auth create и сократите первую ссылку меньше чем за минуту. Все шаги — в быстром старте.