climcpapi
Skracacz linków w CLI dla developerów i agentów AI
Skracaj URL-e z wiersza poleceń w Linkdash CLI. Udostępniaj pliki i teksty, rób testy A/B, targetuj odwiedzających i oddaj linki agentom AI przez MCP.
Igor Kirnosov8 min czytania

Linkdash to skracacz linków, którym sterujesz z terminala. Jedno polecenie zamienia URL, plik albo fragment tekstu w śledzony krótki link na lida.sh i wypisuje wynik jako JSON, który możesz przekazać potokiem dokądkolwiek. Te same operacje są dostępne przez HTTP API i jako serwer MCP, więc agent AI może tworzyć, aktualizować i mierzyć linki dokładnie tymi samymi narzędziami co ty.
Ten poradnik przeprowadzi cię przez całe CLI: instalację, skrócenie pierwszego linku, udostępnianie plików, zabezpieczanie linków, testy A/B, kierowanie odwiedzających według kraju lub urządzenia i czytanie analityki bez otwierania przeglądarki.

Zainstaluj Linkdash CLI
CLI to pakiet npm i wymaga Node.js 20 lub nowszego.
npm i -g linkdash-cli
Tak samo działa pnpm add -g linkdash-cli albo bun add -g linkdash-cli. Instalowane polecenie to linkdash.
Potem w jednym kroku załóż konto i zaloguj CLI:
linkdash auth create
To polecenie otwiera w przeglądarce stronę rejestracji. Gdy już masz konto, zatwierdzasz kod widoczny w terminalu i CLI jest zalogowane. Jeśli masz konto wcześniej, użyj zamiast tego linkdash auth login. linkdash auth whoami potwierdza, z którego konta korzystasz, a dokumentacja CLI wymienia wszystkie polecenia i flagi.
Sesja jest zapisywana w ~/.config/linkdash/config.json z uprawnieniami tylko dla właściciela. W CI i innych środowiskach bez interfejsu ustaw LINKDASH_TOKEN na token sesji z tego pliku na maszynie, na której się zalogowano, i traktuj go jak każdy inny sekret.
Skróć URL z wiersza poleceń
linkdash links create --url https://example.com/pricing --slug pricing
{
"id": "pricing",
"url": "https://lida.sh/pricing",
"kind": "url",
"variants": [
{ "name": "main", "kind": "url" }
]
}
To cały interfejs: udane polecenia wypisują JSON na stdout, a błędy — zwykły tekst na stderr z kodem wyjścia 1. Nie ma flagi --json, bo JSON to jedyny format wyjścia. Dzięki temu CLI łatwo oskryptować. Aby na macOS skopiować świeży krótki link prosto do schowka:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Kilka flag, których będziesz używać cały czas:
--slugustawia publiczną ścieżkę. Slug może zawierać małe litery, cyfry i myślniki w środku, maksymalnie 64 znaki. Pomiń go, a Linkdash wygeneruje własny.--nameto prywatna etykieta widoczna tylko dla ciebie, przydatna do późniejszego wyszukiwania linków.--tagmożna powtarzać, więc--tag launch --tag q4dodaje do linku dwa tagi.--utm-source,--utm-medium,--utm-campaign,--utm-termi--utm-contentdodają parametry kampanii do celu.
Utworzone linki wylistujesz i przeszukasz poleceniem linkdash links list --q pricing --tag launch.
Udostępnij plik albo fragment tekstu
Krótkie linki nie służą tylko do URL-i. To samo polecenie prześle plik albo zapisze fragment tekstu:
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
Link do pliku daje odwiedzającym możliwość pobrania, z podglądem obrazów i wideo. Link do tekstu pokazuje fragment na stronie z przyciskiem kopiowania. Oba są śledzone jak każdy inny link, więc widzisz, kto i kiedy otworzył twoją prezentację. Aby podmienić plik pod istniejącym linkiem bez zmiany URL-a:
linkdash links update board-deck --file ./board-deck-v2.pdf
Decyduj, kto może otworzyć link
Każdy link może mieć własne zasady dostępu:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordprosi odwiedzających o hasło, zanim link się otworzy.--startsi--expiresprzyjmują czas trwania, np.30m,24halbo7d, lub datę ISO. Przed czasem startu link w ogóle nie działa.--max-openingswstrzymuje link po określonej liczbie otwarć, co przydaje się przy jednorazowych pobraniach.
Link możesz w każdej chwili wstrzymać i wznowić poleceniem linkdash links update q4-deck --status paused i --status active.
Zrób test A/B na krótkim linku
W Linkdash każdy link to kontener jednego lub więcej wariantów. Wariant to cel (URL, plik albo tekst) z własną wagą i zasadami. Zwykły link ma jeden wariant o nazwie main. Dodaj kolejne, a krótki link podzieli między nie ruch:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Flagi po każdym --variant należą do tego wariantu aż do następnego. Ruch jest dzielony według wagi, która domyślnie wynosi 1, więc powyższy przykład to test 50/50. Daj wariantowi --weight 3, żeby dostał trzy razy więcej ruchu.
Przypisanie jest domyślnie stałe: powracający odwiedzający dostaje ciągle ten sam wariant, a o to właśnie chodzi w uczciwym teście. Gdy zmieniasz eksperyment, linkdash links update launch --restart-split raz przetasuje wszystkich.

Statystyki przychodzą osobno dla każdego wariantu, więc możesz je porównać bezpośrednio:
linkdash links stats launch --last 7d
Tablica variants w wyniku podaje visits, visitors, downloads i plays dla każdego wariantu. Więcej o statystykach poniżej.
Kieruj odwiedzających według kraju, urządzenia lub parametru zapytania
Warianty mogą też mieć warunki. Dodaj do wariantu --when, a dostaną go tylko pasujący odwiedzający. To zamienia jeden krótki link w router. Na przykład jeden link, który wysyła telefony do właściwego sklepu z aplikacjami:
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
Gdy odwiedzający otwiera link, pulę tworzą warianty, których warunki pasują. Jeśli żaden nie pasuje, używane są warianty bez warunków, więc web powyżej łapie wszystkich, którzy nie korzystają z iOS ani Androida.

Możesz dopasowywać według:
| Klucz | Dopasowuje | Przykład |
|---|---|---|
country |
Kody krajów 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 |
Tagi języków, według prefiksu | --when language=de |
referrer |
Host odsyłający | --when referrer=twitter.com |
Powtórz --when, aby wymagać kilku warunków naraz. --when country=DE,AT --when device=mobile pasuje do odwiedzających z urządzeń mobilnych z Niemiec lub Austrii.
Warianty mogą też dopasowywać query string odwiedzającego, więc jeden link może zachowywać się różnie w zależności od tego, gdzie go udostępnisz. lida.sh/launch?src=newsletter może wysłać czytelników newslettera w specjalne miejsce:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Reguły parametrów obsługują równość (=), nierówność (!=), zawieranie (~=), początek (^=), koniec ($=), jedną z wartości (=a|b), obecność (param:ref?) i brak (param:!ref). Jeśli zamiast tego chcesz przekazywać parametry odwiedzającego do celu, utwórz link z --forward-params.
Panel ma te same opcje, z wyborem krajów wyszukiwanych po nazwie, więc nie musisz pamiętać, że Słowenia to SI:

Czytaj analitykę kliknięć z terminala
linkdash links stats launch --last 7d
Wynik zawiera łączne visits, downloads i plays, liczbę wizyt w wybranym oknie czasowym (visitsInLast), countries i referrers, z których przyszły te wizyty, rozbicie na variants oraz listę visitors z czasem, krajem, urządzeniem, przeglądarką i źródłem odesłania każdej ostatniej wizyty. --last przyjmuje czas trwania, np. 24h albo 30d, a domyślnie wynosi 24h.
Linkdash nie przechowuje adresów IP odwiedzających. Adres służy do ustalenia kraju odwiedzającego i wyprowadzenia anonimowego identyfikatora, który zmienia się codziennie, po czym jest odrzucany.
Aby reagować na kliknięcia na bieżąco, zarejestruj webhook. Linkdash wysyła podpisane zdarzenia link.visit, link.download i link.play na dowolny endpoint HTTPS:
linkdash webhooks create --url https://example.com/hooks
Sekret podpisu jest wypisywany tylko raz, więc od razu go zapisz. Jak weryfikować podpisy, opisuje dokumentacja webhooków.
Pozwól agentom AI tworzyć krótkie linki przez MCP
Wszystko powyższe jest dostępne także dla agentów AI. Linkdash udostępnia zdalny serwer MCP pod https://api.linkdash.dev/mcp, a jego narzędzia odpowiadają poleceniom CLI: links_create, links_update, links_stats, variants_add, domains_add i pozostałe, zwracając ten sam JSON.
Utwórz klucz API w panelu, w sekcji Klucze API, a potem podłącz agenta. W Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
W Cursor dodaj go do .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
W Codex, który czyta klucz ze wskazanej zmiennej środowiskowej:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Od tej chwili możesz prosić o linki zwykłym językiem, np. „skróć https://example.com/pricing jako pricing i otaguj go launch” albo „który wariant launch miał w tym tygodniu więcej odwiedzających?”, a agent wywoła właściwe narzędzie. Dokumentacja MCP opisuje też OpenCode.
Jeśli twój agent już pracuje w terminalu, może korzystać bezpośrednio z CLI. Zainstaluj skill Linkdash dla agentów, żeby znał polecenia i flagi:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Korzystaj z HTTP API
We własnym kodzie te same operacje to zwykłe REST API pod https://api.linkdash.dev/v1, uwierzytelniane tym samym kluczem 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" }'
Odpowiedź ma ten sam kształt co wynik CLI. Dokumentacja API opisuje każdy endpoint, w tym przesyłanie plików i warianty.
Używaj własnej domeny
Krótkie linki domyślnie działają na lida.sh. Aby udostępniać je z własnej domeny, dodaj ją i skieruj DNS na Linkdash:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Potem twórz na niej linki z --domain go.example.com. Każda własna domena ma własną pulę slugów, więc go.example.com/launch nie koliduje z niczyim innym launch. Poradnik o domenach opisuje konfigurację DNS, w tym konfigurację jednym kliknięciem u dostawców, którzy ją obsługują.
Cennik
Plan Free nie wymaga karty kredytowej i obejmuje 5000 zdarzeń miesięcznie, 1 GB miejsca na pliki, miesiąc historii analityki i jedną własną domenę. Zdarzenie to wizyta, pobranie lub odtworzenie na jednym z twoich linków albo zapis, np. utworzenie lub aktualizacja linku. Odczyty, np. listowanie linków czy pobieranie statystyk, są darmowe.
Płatne plany podnoszą te limity: Professional kosztuje 18 USD miesięcznie, a Growth 48 USD miesięcznie. Pełne porównanie znajdziesz w cenniku.
FAQ
Czy istnieje darmowy skracacz linków z CLI?
Tak. Linkdash CLI działa w planie Free, który obejmuje 5000 zdarzeń miesięcznie bez karty kredytowej.
Czy mogę używać Linkdash CLI w CI?
Tak. Ustaw LINKDASH_TOKEN na token sesji, a CLI zadziała bez przeglądarki. Ponieważ każde polecenie wypisuje JSON, możesz tworzyć i aktualizować linki z GitHub Actions lub dowolnego innego pipeline’u i czytać wyniki przez jq.
Czy agenty AI mogą tworzyć krótkie linki?
Tak, na trzy sposoby: przez serwer MCP pod https://api.linkdash.dev/mcp, przez CLI z zainstalowanym skillem Linkdash dla agentów albo przez HTTP API. Wszystkie trzy udostępniają te same operacje i zwracają ten sam JSON.
Czy Linkdash przechowuje adresy IP odwiedzających?
Nie. Linkdash używa adresu do ustalenia kraju odwiedzającego i utworzenia dziennego anonimowego identyfikatora, po czym go odrzuca. Właściciele linków nigdy nie widzą adresów IP.
Czy jeden krótki link może wysyłać różnych odwiedzających na różne strony?
Tak. Daj linkowi kilka wariantów i dodaj do każdego warunki, np. kraj, urządzenie, system operacyjny, język, źródło odesłania albo parametr zapytania. Bez warunków warianty dzielą ruch według wag — tak właśnie robi się test A/B.
Chcesz spróbować? Zainstaluj CLI, uruchom linkdash auth create i skróć pierwszy link w niecałą minutę. Szybki start opisuje każdy krok.

