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í

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.

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:
--slugnastaví veřejnou cestu. Slugy obsahují malá písmena, číslice a pomlčky uvnitř, nejvýše 64 znaků. Když ho vynecháte, Linkdash ho vygeneruje.--nameje soukromý popisek, který vidíte jen vy; hodí se k pozdějšímu hledání odkazů.--taglze opakovat, takže--tag launch --tag q4přidá odkazu dva štítky.--utm-source,--utm-medium,--utm-campaign,--utm-terma--utm-contentpř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
--passwordvyžádá od návštěvníků heslo, než se odkaz otevře.--startsa--expirespřijímají dobu jako30m,24hnebo7d, případně datum ve formátu ISO. Před časem začátku se odkaz vůbec nepřeloží.--max-openingspozastaví 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á.

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.

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:

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.

