climcpapi
Skracovač URL v CLI pre vývojárov a AI agentov
Skracujte URL z príkazového riadka s Linkdash CLI. Zdieľajte súbory a úryvky, robte A/B testy, cieľte na návštevníkov a odkazy spravujte s AI agentmi cez MCP.
Igor Kirnosov8 min čítania

Linkdash je skracovač URL, ktorý ovládate z terminálu. Jeden príkaz premení URL, súbor alebo textový úryvok na sledovaný krátky odkaz na lida.sh a výsledok vypíše ako JSON, ktorý môžete poslať ďalej do čohokoľvek. Rovnaké operácie sú dostupné cez HTTP API aj ako MCP server, takže AI agent môže vytvárať, upravovať a merať odkazy presne tými istými nástrojmi ako vy.
Tento návod prechádza celým CLI: inštaláciou, skrátením prvého odkazu, zdieľaním súborov, zabezpečením odkazov, A/B testami, smerovaním návštevníkov podľa krajiny či zariadenia a čítaním analytiky bez otvorenia prehliadača.

Inštalácia Linkdash CLI
CLI je balík npm a vyžaduje Node.js 20 alebo novší.
npm i -g linkdash-cli
Rovnako funguje aj s pnpm add -g linkdash-cli alebo bun add -g linkdash-cli. Nainštalovaný príkaz sa volá linkdash.
Potom si v jednom kroku vytvorte účet a prihláste CLI:
linkdash auth create
V prehliadači sa otvorí registračná stránka. Keď máte účet, schválite kód zobrazený v termináli a CLI je prihlásené. Ak už účet máte, použite namiesto toho linkdash auth login. linkdash auth whoami potvrdí, aký účet používate, a referenčná príručka CLI uvádza všetky príkazy a prepínače.
Relácia sa ukladá do ~/.config/linkdash/config.json s oprávneniami iba pre vlastníka. Pre CI a iné prostredia bez rozhrania nastavte LINKDASH_TOKEN na token relácie z tohto súboru na počítači, kde ste sa prihlásili, a zaobchádzajte s ním ako s každým iným tajomstvom.
Skrátenie URL z príkazového riadka
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 je celé rozhranie: úspešné príkazy vypisujú JSON na stdout a chyby vypisujú čistý text na stderr s návratovým kódom 1. Prepínač --json neexistuje, pretože JSON je jediný výstup. Vďaka tomu sa CLI ľahko skriptuje. Nový krátky odkaz skopírujete na macOS rovno do schránky takto:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Niekoľko prepínačov, ktoré budete používať neustále:
--slugnastaví verejnú cestu. Slugy používajú malé písmená, číslice a pomlčky vo vnútri, najviac 64 znakov. Ak ho vynecháte, Linkdash ho vygeneruje.--nameje súkromný štítok, ktorý vidíte iba vy, užitočný na neskoršie vyhľadávanie odkazov.--tagsa dá opakovať, takže--tag launch --tag q4pridá odkazu dva štítky.--utm-source,--utm-medium,--utm-campaign,--utm-terma--utm-contentpridajú do cieľa parametre kampane.
Vytvorené odkazy zobrazíte a vyhľadáte príkazom linkdash links list --q pricing --tag launch.
Zdieľanie súboru alebo textového úryvku
Krátke odkazy nie sú len pre URL. Ten istý príkaz nahrá súbor alebo uloží úryvok:
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
Odkaz na súbor ponúkne návštevníkom stiahnutie, pri obrázkoch a videách s náhľadom. Textový odkaz zobrazí úryvok na stránke s tlačidlom na kopírovanie. Oba sa sledujú ako každý iný odkaz, takže vidíte, kto a kedy otvoril vašu prezentáciu. Súbor za existujúcim odkazom nahradíte bez zmeny URL takto:
linkdash links update board-deck --file ./board-deck-v2.pdf
Kto môže odkaz otvoriť
Každý odkaz môže mať vlastné pravidlá prístupu:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordvyžiada od návštevníkov heslo, než sa odkaz otvorí.--startsa--expiresprijímajú trvanie ako30m,24halebo7d, prípadne dátum ISO. Pred časom začiatku sa odkaz vôbec nepreloží.--max-openingspozastaví odkaz po danom počte otvorení, čo sa hodí na jednorazové stiahnutia.
Odkaz môžete kedykoľvek pozastaviť a obnoviť príkazom linkdash links update q4-deck --status paused a --status active.
A/B test na krátkom odkaze
V Linkdash je každý odkaz kontajnerom jedného alebo viacerých variantov. Variant je cieľ (URL, súbor alebo text) s vlastnou váhou a pravidlami. Bežný odkaz má jeden variant s názvom main. Pridajte ďalšie a krátky odkaz medzi ne rozdelí návštevnosť:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Prepínače za každým --variant patria danému variantu až po ďalší. Návštevnosť sa rozdeľuje podľa váhy, ktorá je predvolene 1, takže príklad vyššie je test 50/50. Ak dáte variantu --weight 3, pošlete mu trikrát viac návštevnosti.
Priradenie je predvolene trvalé: vracajúci sa návštevník dostáva stále ten istý variant, čo pri férovom teste chcete. Keď experiment zmeníte, linkdash links update launch --restart-split raz všetkých znova rozdelí.

Štatistiky prichádzajú za každý variant, takže ich môžete priamo porovnať:
linkdash links stats launch --last 7d
Pole variants vo výstupe uvádza visits, visitors, downloads a plays pre každý variant. Viac o štatistikách nižšie.
Smerovanie návštevníkov podľa krajiny, zariadenia alebo parametra dopytu
Varianty môžu mať aj podmienky. Pridajte k variantu --when a dostať ho môžu iba návštevníci, ktorí podmienke zodpovedajú. Z jedného krátkeho odkazu sa tak stane smerovač. Napríklad jeden odkaz, ktorý pošle telefóny do správneho obchodu s aplikáciami:
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
Keď návštevník otvorí odkaz, výber tvoria varianty, ktorých podmienky zodpovedajú. Ak nezodpovedá žiadny, použijú sa varianty bez podmienok, takže web vyššie zachytí každého, kto nemá iOS ani Android.

Podmienky môžu porovnávať:
| Kľúč | Zodpovedá | Príklad |
|---|---|---|
country |
Kódy krajín 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 |
Jazykové značky podľa predpony | --when language=de |
referrer |
Odkazujúci hostiteľ | --when referrer=twitter.com |
Ak chcete vyžadovať niekoľko podmienok naraz, zopakujte --when. --when country=DE,AT --when device=mobile zodpovedá mobilným návštevníkom z Nemecka alebo Rakúska.
Varianty môžu porovnávať aj reťazec dopytu návštevníka, takže jeden odkaz sa môže správať inak podľa toho, kde ste ho zdieľali. lida.sh/launch?src=newsletter môže poslať čitateľov newslettra na osobitné miesto:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Pravidlá parametrov podporujú rovná sa (=), nerovná sa (!=), obsahuje (~=), začína na (^=), končí na ($=), jedno z (=a|b), existuje (param:ref?) a chýba (param:!ref). Ak chcete parametre návštevníka namiesto toho odovzdať do cieľa, vytvorte odkaz s --forward-params.
Ovládací panel má rovnaké ovládacie prvky s výberom krajín, ktorý vyhľadáva podľa názvu, takže si nemusíte pamätať, že Slovinsko je SI:

Analytika kliknutí v termináli
linkdash links stats launch --last 7d
Výstup obsahuje celkové visits, downloads a plays, počet návštev v zvolenom období (visitsInLast), countries a referrers, odkiaľ návštevy prišli, rozpis variants a zoznam visitors s časom, krajinou, zariadením, prehliadačom a referrerom každej nedávnej návštevy. --last prijíma trvanie ako 24h alebo 30d a predvolene je 24h.
Linkdash neukladá IP adresy návštevníkov. Adresa sa použije na zistenie krajiny návštevníka a na odvodenie anonymného identifikátora návštevníka, ktorý sa denne mení, a potom sa zahodí.
Ak chcete na kliknutia reagovať hneď, ako nastanú, zaregistrujte webhook. Linkdash posiela podpísané udalosti link.visit, link.download a link.play na akýkoľvek HTTPS endpoint:
linkdash webhooks create --url https://example.com/hooks
Podpisový kľúč sa vypíše iba raz, takže si ho hneď uložte. Overovanie podpisov popisuje dokumentácia k webhookom.
AI agenti vytvárajú krátke odkazy cez MCP
Všetko uvedené je dostupné aj AI agentom. Linkdash prevádzkuje vzdialený MCP server na https://api.linkdash.dev/mcp a jeho nástroje zodpovedajú CLI: links_create, links_update, links_stats, variants_add, domains_add a ďalšie, ktoré vracajú ten istý JSON.
Vytvorte si v ovládacom paneli v časti API kľúče API kľúč a potom pripojte svojho agenta. V Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
V Cursor ho pridajte do .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
V Codex, ktorý číta kľúč z premennej prostredia, ktorú zadáte:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Odvtedy môžete o odkazy žiadať bežnou rečou, napríklad „skráť https://example.com/pricing ako pricing a označ ho štítkom launch“ alebo „ktorý variant launch mal tento týždeň viac návštevníkov?“, a agent zavolá správny nástroj. Dokumentácia k MCP popisuje aj OpenCode.
Ak váš agent už pracuje v termináli, môže CLI používať priamo. Nainštalujte skill Linkdash pre agentov, aby poznal príkazy a prepínače:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Použitie HTTP API
Pre váš vlastný kód sú tie isté operácie dostupné ako jednoduché REST API na https://api.linkdash.dev/v1, overované tým istým API kľúčom:
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" }'
Odpoveď má rovnaký tvar ako výstup CLI. Referenčná príručka API popisuje všetky endpointy vrátane nahrávania súborov a variantov.
Použitie vlastnej domény
Krátke odkazy predvolene žijú na lida.sh. Ak ich chcete obsluhovať z vlastnej domény, pridajte ju a nasmerujte DNS na Linkdash:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Potom na nej vytvárajte odkazy s --domain go.example.com. Každá vlastná doména má vlastnú sadu slugov, takže go.example.com/launch sa nebije s nikoho iného launch. Návod k doménam popisuje nastavenie DNS vrátane nastavenia jedným kliknutím u poskytovateľov, ktorí ho podporujú.
Ceny
Plán Free nevyžaduje platobnú kartu a zahŕňa 5 000 udalostí mesačne, 1 GB úložiska súborov, mesiac histórie analytiky a jednu vlastnú doménu. Udalosť je návšteva, stiahnutie alebo prehratie na niektorom z vašich odkazov, prípadne zápis, napríklad vytvorenie alebo úprava odkazu. Čítania, ako zobrazenie zoznamu odkazov alebo načítanie štatistík, sú zadarmo.
Platené plány tieto limity zvyšujú: Professional stojí 18 $ mesačne a Growth 48 $ mesačne. Kompletné porovnanie nájdete v cenníku.
Časté otázky
Existuje bezplatný skracovač URL s CLI?
Áno. Linkdash CLI funguje v pláne Free, ktorý zahŕňa 5 000 udalostí mesačne bez platobnej karty.
Môžem Linkdash CLI používať v CI?
Áno. Nastavte LINKDASH_TOKEN na token relácie a CLI bude fungovať bez prehliadača. Keďže každý príkaz vypisuje JSON, môžete vytvárať a upravovať odkazy z GitHub Actions alebo akejkoľvek inej pipeline a výsledky čítať cez jq.
Môžu AI agenti vytvárať krátke odkazy?
Áno, tromi spôsobmi: cez MCP server na https://api.linkdash.dev/mcp, cez CLI s nainštalovaným skillom Linkdash pre agentov alebo cez HTTP API. Všetky tri sprístupňujú rovnaké operácie a vracajú ten istý JSON.
Ukladá Linkdash IP adresy návštevníkov?
Nie. Linkdash použije adresu na zistenie krajiny návštevníka a na vytvorenie denného anonymného identifikátora a potom ju zahodí. Vlastníci odkazov IP adresy nikdy nevidia.
Môže jeden krátky odkaz posielať rôznych návštevníkov na rôzne stránky?
Áno. Dajte odkazu niekoľko variantov a ku každému pridajte podmienky, napríklad krajinu, zariadenie, operačný systém, jazyk, referrer alebo parameter dopytu. Bez podmienok varianty rozdeľujú návštevnosť podľa váhy, a takto sa robí A/B test.
Chcete to vyskúšať? Nainštalujte CLI, spustite linkdash auth create a svoj prvý odkaz skrátite za menej ako minútu. Všetky kroky nájdete v rýchlom štarte.

