Preskočiť na obsah
Všetky články

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

Terminál vytvára krátky odkaz Linkdash príkazom linkdash links create

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.

Ovládací panel Linkdash so zoznamom krátkych odkazov s ich typom, slugom, cieľom a stavom

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:

  • --slug nastaví 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.
  • --name je súkromný štítok, ktorý vidíte iba vy, užitočný na neskoršie vyhľadávanie odkazov.
  • --tag sa dá opakovať, takže --tag launch --tag q4 pridá odkazu dva štítky.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term a --utm-content pridajú 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
  • --password vyžiada od návštevníkov heslo, než sa odkaz otvorí.
  • --starts a --expires prijímajú trvanie ako 30m, 24h alebo 7d, prípadne dátum ISO. Pred časom začiatku sa odkaz vôbec nepreloží.
  • --max-openings pozastaví 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í.

Odkaz v Linkdash s dvoma variantmi, control a annual-first, ktorý rozdeľuje návštevnosť medzi dve cenníkové stránky

Š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.

Odkaz v Linkdash smeruje návštevníkov s iOS do App Store, s Androidom do Google Play a všetkých ostatných na webovú stránku

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:

Výber cieľových krajín pre variant v ovládacom paneli Linkdash s vybraným Nemeckom a Rakúskom

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.