climcpapi
CLI за съкращаване на URL адреси за разработчици и AI агенти
Съкращавайте URL адреси от командния ред с Linkdash CLI. Споделяйте файлове, правете A/B тестове, таргетирайте посетители и работете с AI агенти чрез MCP.
Igor Kirnosov9 мин четене

Linkdash е съкращател на URL адреси, който управлявате от терминала. Една команда превръща URL, файл или текстов фрагмент в проследявана кратка връзка на lida.sh и извежда резултата като JSON, който можете да подадете по pipe към всичко. Същите операции са достъпни и чрез HTTP API, и като MCP сървър, така че AI агент може да създава, променя и измерва връзки със същите инструменти, които използвате вие.
Това ръководство обхваща целия 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 със session 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 генерира такъв.--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 съвпада с мобилни посетители от Германия или Австрия.
Вариантите могат да проверяват и query низа на посетителя, така че една връзка може да се държи различно в зависимост от това къде сте я споделили. 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 адресите на посетителите. Адресът се използва, за да се определи държавата на посетителя и да се изведе анонимен идентификатор на посетителя, който се сменя всеки ден, след което се изтрива.
За да реагирате на кликванията в момента, в който се случват, регистрирайте webhook. Linkdash изпраща подписани събития link.visit, link.download и link.play до всеки HTTPS endpoint:
linkdash webhooks create --url https://example.com/hooks
Секретът за подписване се извежда веднъж, така че го запазете веднага. Вижте документацията за webhooks за проверката на подписите.
Оставете AI агентите да създават кратки връзки чрез MCP
Всичко по-горе е достъпно и за AI агенти. 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 директно. Инсталирайте skill-а за агенти на 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 описва всеки endpoint, включително качването на файлове и вариантите.
Използвайте собствен домейн
По подразбиране кратките връзки са на 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 GB хранилище за файлове, един месец история на аналитиката и един собствен домейн. Събитие е посещение, изтегляне или възпроизвеждане на някоя от вашите връзки или запис, например създаване или промяна на връзка. Четенията, като извеждане на списък с връзки или извличане на статистика, са безплатни.
Платените планове увеличават тези лимити: Professional струва $18 на месец, а Growth — $48 на месец. Вижте цените за пълното сравнение.
Често задавани въпроси
Има ли безплатен съкращател на URL адреси с CLI?
Да. Linkdash CLI работи с плана Free, който включва 5 000 събития на месец, без кредитна карта.
Мога ли да използвам Linkdash CLI в CI?
Да. Задайте LINKDASH_TOKEN със session token и CLI работи без браузър. Тъй като всяка команда извежда JSON, можете да създавате и променяте връзки от GitHub Actions или всеки друг pipeline и да четете резултатите с jq.
Могат ли AI агенти да създават кратки връзки?
Да, по три начина: чрез MCP сървъра на https://api.linkdash.dev/mcp, чрез CLI с инсталиран skill за агенти на Linkdash или чрез HTTP API. И трите предоставят едни и същи операции и връщат един и същ JSON.
Съхранява ли Linkdash IP адресите на посетителите?
Не. Linkdash използва адреса, за да определи държавата на посетителя и да създаде дневен анонимен идентификатор, след което го изтрива. Собствениците на връзки никога не виждат IP адреси.
Може ли една кратка връзка да праща различни посетители към различни страници?
Да. Дайте на връзката няколко варианта и добавете към всеки условия като държава, устройство, операционна система, език, източник или параметър на заявката. Без условия вариантите разделят трафика според теглото — така се прави A/B тест.
Готови ли сте да опитате? Инсталирайте CLI, изпълнете linkdash auth create и съкратете първата си връзка за по-малко от минута. Бързият старт съдържа всички стъпки.

