Przejdź do treści
Wszystkie wpisy

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

Terminal tworzący krótki link Linkdash poleceniem linkdash links create

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.

Panel Linkdash z listą krótkich linków, ich rodzajem, slugiem, celem i statusem

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:

  • --slug ustawia 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.
  • --name to prywatna etykieta widoczna tylko dla ciebie, przydatna do późniejszego wyszukiwania linków.
  • --tag można powtarzać, więc --tag launch --tag q4 dodaje do linku dwa tagi.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term i --utm-content dodają 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

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
  • --password prosi odwiedzających o hasło, zanim link się otworzy.
  • --starts i --expires przyjmują czas trwania, np. 30m, 24h albo 7d, lub datę ISO. Przed czasem startu link w ogóle nie działa.
  • --max-openings wstrzymuje 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.

Link w Linkdash z dwoma wariantami, control i annual-first, dzielący ruch między dwie strony z cennikiem

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.

Link w Linkdash kierujący odwiedzających z iOS do App Store, z Androida do Google Play, a wszystkich innych na stronę internetową

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:

Wybór krajów docelowych dla wariantu w panelu Linkdash, z zaznaczonymi Niemcami i Austrią

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.

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.

Linkdash

© 2026 Igor Kirnosov s.p. Wszelkie prawa zastrzeżone.