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

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

Установите 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 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.

Условия можно задавать по:
| Ключ | Что проверяет | Пример |
|---|---|---|
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 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 и сократите первую ссылку меньше чем за минуту. Все шаги — в быстром старте.

