Přeskočit na obsah
Všechny články

climcpapi

Zkracovač URL s CLI pro vývojáře a AI agenty

Zkracujte URL z příkazové řádky s Linkdash CLI. Sdílejte soubory a úryvky, dělejte A/B testy, cilte na návštěvníky a svěřte odkazy AI agentům přes MCP.

Igor Kirnosov8 min čtení

Terminál, který příkazem linkdash links create vytváří krátký odkaz Linkdash

Linkdash je zkracovač URL, který ovládáte z terminálu. Jeden příkaz udělá z URL, souboru nebo textového úryvku sledovaný krátký odkaz na lida.sh a vypíše výsledek jako JSON, který můžete poslat rourou kamkoli dál. Stejné operace jsou dostupné přes HTTP API a jako MCP server, takže AI agent může vytvářet, upravovat a měřit odkazy přesně stejnými nástroji jako vy.

Tento návod projde celé CLI: instalaci, zkrácení prvního odkazu, sdílení souborů, zabezpečení odkazů, A/B testy, směrování návštěvníků podle země nebo zařízení a čtení analytiky bez otevírání prohlížeče.

Dashboard Linkdash se seznamem krátkých odkazů, jejich typem, slugem, cílem a stavem

Instalace Linkdash CLI

CLI je npm balíček a potřebuje Node.js 20 nebo novější.

npm i -g linkdash-cli

Stejně funguje i pnpm add -g linkdash-cli nebo bun add -g linkdash-cli. Nainstalovaný příkaz se jmenuje linkdash.

Pak jedním krokem vytvořte účet a přihlaste CLI:

linkdash auth create

V prohlížeči se otevře registrační stránka. Jakmile máte účet, schválíte kód zobrazený v terminálu a CLI je přihlášené. Pokud už účet máte, použijte místo toho linkdash auth login. linkdash auth whoami ukáže, jaký účet používáte, a reference CLI obsahuje všechny příkazy a flagy.

Relace se ukládá do ~/.config/linkdash/config.json s oprávněními jen pro vlastníka. Pro CI a jiná prostředí bez prohlížeče nastavte LINKDASH_TOKEN na token relace z tohoto souboru na počítači, kde jste přihlášení, a zacházejte s ním jako s každým jiným tajným klíčem.

Zkrácení URL z příkazové řádky

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é rozhraní: úspěšné příkazy vypisují JSON na stdout a chyby vypisují prostý text na stderr s návratovým kódem 1. Flag --json neexistuje, protože JSON je jediný výstup. Díky tomu se CLI snadno skriptuje. Takto na macOS zkopírujete nový krátký odkaz rovnou do schránky:

linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy

Pár flagů, které budete používat neustále:

  • --slug nastaví veřejnou cestu. Slugy obsahují malá písmena, číslice a pomlčky uvnitř, nejvýše 64 znaků. Když ho vynecháte, Linkdash ho vygeneruje.
  • --name je soukromý popisek, který vidíte jen vy; hodí se k pozdějšímu hledání odkazů.
  • --tag lze opakovat, takže --tag launch --tag q4 přidá odkazu dva štítky.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term a --utm-content přidají do cíle parametry kampaně.

Vytvořené odkazy vypíšete a prohledáte příkazem linkdash links list --q pricing --tag launch.

Sdílení souboru nebo textového úryvku

Krátké odkazy nejsou jen pro URL. Stejný příkaz nahraje soubor nebo uloží úryvek:

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 soubor nabídne návštěvníkům stažení, u obrázků a videí i s náhledem. Textový odkaz zobrazí úryvek na stránce s tlačítkem pro kopírování. Oba se sledují jako každý jiný odkaz, takže uvidíte, kdo a kdy otevřel vaši prezentaci. Soubor za existujícím odkazem nahradíte beze změny URL takto:

linkdash links update board-deck --file ./board-deck-v2.pdf

Kdo může odkaz otevřít

Každý odkaz může mít vlastní pravidla přístupu:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • --password vyžádá od návštěvníků heslo, než se odkaz otevře.
  • --starts a --expires přijímají dobu jako 30m, 24h nebo 7d, případně datum ve formátu ISO. Před časem začátku se odkaz vůbec nepřeloží.
  • --max-openings pozastaví odkaz po daném počtu otevření, což se hodí pro jednorázová stažení.

Odkaz můžete kdykoli pozastavit a znovu spustit příkazem linkdash links update q4-deck --status paused a --status active.

A/B test na krátkém odkazu

V Linkdash je každý odkaz kontejnerem jedné nebo více variant. Varianta je cíl (URL, soubor nebo text) s vlastní váhou a pravidly. Běžný odkaz má jednu variantu s názvem main. Přidejte další a krátký odkaz mezi ně rozdělí provoz:

linkdash links create --slug launch \
  --variant control --url https://example.com/pricing \
  --variant annual-first --url "https://example.com/pricing?view=annual"

Flagy za každým --variant patří k této variantě až do další. Provoz se dělí podle váhy, která je ve výchozím stavu 1, takže příklad výše je test 50/50. Dejte variantě --weight 3 a dostane trojnásobek provozu.

Přiřazení je ve výchozím stavu trvalé: vracející se návštěvník dostává stále stejnou variantu, což je pro férový test přesně to, co chcete. Když experiment změníte, linkdash links update launch --restart-split jednou všechny znovu zamíchá.

Odkaz Linkdash se dvěma variantami, control a annual-first, který dělí provoz mezi dvě cenové stránky

Statistiky se vracejí po variantách, takže je můžete přímo porovnat:

linkdash links stats launch --last 7d

Pole variants ve výstupu uvádí pro každou variantu visits, visitors, downloads a plays. Více o statistikách níže.

Směrování návštěvníků podle země, zařízení nebo parametru dotazu

Varianty mohou mít i podmínky. Přidejte k variantě --when a dostanou ji jen návštěvníci, kteří podmínky splní. Z jednoho krátkého odkazu se tak stane router. Například jeden odkaz, který pošle telefony do správného obchodu s aplikacemi:

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

Když návštěvník odkaz otevře, výběr tvoří varianty, jejichž podmínky odpovídají. Pokud žádná neodpovídá, použijí se varianty bez podmínek, takže web výše zachytí každého, kdo není na iOS ani Androidu.

Odkaz Linkdash, který směruje návštěvníky na iOS do App Storu, na Androidu do Google Play a všechny ostatní na webovou stránku

Podmínky můžete nastavit podle:

Klíč Odpovídá Příklad
country Kódy zemí 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é tagy, podle prefixu --when language=de
referrer Hostitel refereru --when referrer=twitter.com

Opakováním --when vyžadujete několik podmínek současně. --when country=DE,AT --when device=mobile odpovídá mobilním návštěvníkům z Německa nebo Rakouska.

Varianty mohou odpovídat i query stringu návštěvníka, takže se jeden odkaz může chovat různě podle toho, kde jste ho nasdíleli. lida.sh/launch?src=newsletter může poslat čtenáře newsletteru na speciální stránku:

linkdash links variants add launch --name newsletter \
  --url https://example.com/pricing/newsletter \
  --when param:src=newsletter

Pravidla parametrů podporují rovná se (=), nerovná se (!=), obsahuje (~=), začíná na (^=), končí na ($=), jedna z (=a|b), existuje (param:ref?) a chybí (param:!ref). Pokud chcete parametry návštěvníka místo toho předat do cíle, vytvořte odkaz s --forward-params.

Dashboard má stejné ovládání, včetně výběru zemí s vyhledáváním podle názvu, takže si nemusíte pamatovat, že Slovinsko je SI:

Výběr cílových zemí pro variantu v dashboardu Linkdash, s vybraným Německem a Rakouskem

Analytika kliknutí v terminálu

linkdash links stats launch --last 7d

Výstup obsahuje celkové visits, downloads a plays, počet návštěv v zadaném okně (visitsInLast), countries a referrers, odkud návštěvy přišly, rozpad podle variants a seznam visitors s časem, zemí, zařízením, prohlížečem a refererem každé nedávné návštěvy. --last přijímá dobu jako 24h nebo 30d a výchozí hodnota je 24h.

Linkdash neukládá IP adresy návštěvníků. Adresa se použije ke zjištění země návštěvníka a k odvození anonymního identifikátoru, který se denně mění, a pak se zahodí.

Chcete-li na kliknutí reagovat v reálném čase, zaregistrujte webhook. Linkdash posílá podepsané události link.visit, link.download a link.play na jakýkoli HTTPS endpoint:

linkdash webhooks create --url https://example.com/hooks

Podpisový klíč se vypíše jen jednou, takže si ho hned uložte. Ověřování podpisů popisuje dokumentace webhooků.

Krátké odkazy od AI agentů přes MCP

Vše výše je dostupné i AI agentům. Linkdash provozuje vzdálený MCP server na https://api.linkdash.dev/mcp a jeho nástroje kopírují CLI: links_create, links_update, links_stats, variants_add, domains_add a další, se stejným JSON výstupem.

V dashboardu vytvořte API klíč v sekci API klíče a pak připojte svého agenta. V Claude Code:

claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
  --header "Authorization: Bearer $LINKDASH_API_KEY"

V Cursoru ho přidejte do .cursor/mcp.json:

{
  "mcpServers": {
    "linkdash": {
      "url": "https://api.linkdash.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
    }
  }
}

V Codexu, který čte klíč z proměnné prostředí, kterou zadáte:

codex mcp add linkdash --url https://api.linkdash.dev/mcp \
  --bearer-token-env-var LINKDASH_API_KEY

Od té chvíle můžete o odkazy žádat běžnou řečí, například „zkrať https://example.com/pricing jako pricing a dej mu štítek launch“ nebo „která varianta launch měla tento týden víc návštěvníků?“, a agent zavolá správný nástroj. Dokumentace MCP pokrývá i OpenCode.

Pokud váš agent už pracuje v terminálu, může CLI používat přímo. Nainstalujte mu skill Linkdash, aby znal příkazy a flagy:

npx skills add https://linkdash.dev/skills/linkdash/SKILL.md

HTTP API

Pro váš vlastní kód jsou stejné operace dostupné jako obyčejné REST API na https://api.linkdash.dev/v1, ověřované stejným API klíčem:

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" }'

Odpověď má stejný tvar jako výstup CLI. Reference API pokrývá všechny endpointy, včetně nahrávání souborů a variant.

Vlastní doména

Krátké odkazy jsou ve výchozím stavu na lida.sh. Chcete-li je poskytovat z vlastní domény, přidejte ji a nasměrujte DNS na Linkdash:

linkdash domains add go.example.com
linkdash domains verify go.example.com

Pak na ní vytvářejte odkazy s --domain go.example.com. Každá vlastní doména má vlastní sadu slugů, takže go.example.com/launch nekoliduje s cizím launch. Návod k doménám popisuje nastavení DNS, včetně nastavení jedním kliknutím u poskytovatelů, kteří ho podporují.

Ceník

Tarif Free nevyžaduje platební kartu a zahrnuje 5 000 událostí měsíčně, 1 GB úložiště souborů, měsíc historie analytiky a jednu vlastní doménu. Událost je návštěva, stažení nebo přehrání některého z vašich odkazů, nebo zápis, například vytvoření či úprava odkazu. Čtení, jako výpis odkazů nebo načtení statistik, je zdarma.

Placené tarify tyto limity zvyšují: Professional stojí 18 $ měsíčně a Growth 48 $ měsíčně. Úplné srovnání najdete v ceníku.

Časté dotazy

Existuje bezplatný zkracovač URL s CLI?

Ano. Linkdash CLI funguje v tarifu Free, který zahrnuje 5 000 událostí měsíčně bez platební karty.

Můžu Linkdash CLI používat v CI?

Ano. Nastavte LINKDASH_TOKEN na token relace a CLI poběží bez prohlížeče. Protože každý příkaz vypisuje JSON, můžete vytvářet a upravovat odkazy z GitHub Actions nebo jakékoli jiné pipeline a výsledky číst pomocí jq.

Mohou AI agenti vytvářet krátké odkazy?

Ano, třemi způsoby: přes MCP server na https://api.linkdash.dev/mcp, přes CLI s nainstalovaným skillem Linkdash, nebo přes HTTP API. Všechny tři nabízejí stejné operace a vracejí stejný JSON.

Ukládá Linkdash IP adresy návštěvníků?

Ne. Linkdash adresu použije ke zjištění země návštěvníka a k vytvoření denního anonymního identifikátoru a pak ji zahodí. Vlastníci odkazů IP adresy nikdy nevidí.

Může jeden krátký odkaz posílat různé návštěvníky na různé stránky?

Ano. Dejte odkazu několik variant a ke každé přidejte podmínky, jako je země, zařízení, operační systém, jazyk, referrer nebo parametr dotazu. Bez podmínek si varianty dělí provoz podle váhy — a přesně tak se dělá A/B test.


Chcete to vyzkoušet? Nainstalujte CLI, spusťte linkdash auth create a zkraťte svůj první odkaz za méně než minutu. Všechny kroky najdete v rychlém startu.