climcpapi
Skrajševalnik URL-jev v CLI za razvijalce in agente UI
Skrajšajte URL-je iz ukazne vrstice z Linkdash CLI. Delite datoteke in izseke, A/B-testirajte, ciljajte obiskovalce in prepustite povezave agentom prek MCP.
Igor Kirnosov9 min branja

Linkdash je skrajševalnik URL-jev, ki ga upravljate iz terminala. En ukaz spremeni URL, datoteko ali izsek besedila v sledeno kratko povezavo na lida.sh in rezultat izpiše kot JSON, ki ga lahko preusmerite v kar koli. Iste operacije so na voljo prek HTTP API in kot strežnik MCP, zato lahko agent UI ustvarja, posodablja in meri povezave z natanko istimi orodji kot vi.
Ta vodnik predstavi celoten CLI: namestitev, skrajšanje prve povezave, deljenje datotek, zaklepanje povezav, A/B-teste, usmerjanje obiskovalcev po državi ali napravi in branje analitike, ne da bi odprli brskalnik.

Namestite Linkdash CLI
CLI je paket npm in potrebuje Node.js 20 ali novejši.
npm i -g linkdash-cli
Enako deluje s pnpm add -g linkdash-cli ali bun add -g linkdash-cli. Ukaz, ki ga namesti, je linkdash.
Nato v enem koraku ustvarite račun in prijavite CLI:
linkdash auth create
To v brskalniku odpre stran za registracijo. Ko imate račun, odobrite kodo, prikazano v terminalu, in CLI je prijavljen. Če račun že imate, namesto tega uporabite linkdash auth login. linkdash auth whoami potrdi, kateri račun uporabljate, referenca CLI pa navaja vse ukaze in zastavice.
Seja je shranjena v ~/.config/linkdash/config.json z dovoljenji samo za lastnika. Za CI in druga okolja brez grafičnega vmesnika nastavite LINKDASH_TOKEN na žeton seje iz te datoteke na računalniku, kjer ste prijavljeni, in z njim ravnajte kot z vsako drugo skrivnostjo.
Skrajšajte URL iz ukazne vrstice
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 ves vmesnik: uspešni ukazi izpišejo JSON na stdout, napake pa navadno besedilo na stderr z izhodno kodo 1. Zastavice --json ni, ker je JSON edini izhod. Zato je CLI preprosto uporabljati v skriptah. Če želite novo kratko povezavo v macOS kopirati neposredno v odložišče:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Nekaj zastavic, ki jih boste uporabljali ves čas:
--slugnastavi javno pot. Slugi uporabljajo male črke, številke in notranje vezaje, do 64 znakov. Če ga izpustite, ga Linkdash ustvari sam.--nameje zasebna oznaka, ki jo vidite samo vi, priročna za poznejše iskanje povezav.--taglahko ponovite, zato--tag launch --tag q4povezavi doda dve oznaki.--utm-source,--utm-medium,--utm-campaign,--utm-termin--utm-contentciljnemu URL-ju dodajo parametre kampanje.
Ustvarjeno izpišete in preiščete z linkdash links list --q pricing --tag launch.
Delite datoteko ali izsek besedila
Kratke povezave niso samo za URL-je. Isti ukaz naloži datoteko ali shrani izsek:
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
Povezava do datoteke obiskovalcem ponudi prenos, s predogledom za slike in video. Povezava z besedilom prikaže izsek na strani z gumbom za kopiranje. Obe se spremljata kot vsaka druga povezava, zato vidite, kdo je odprl vašo predstavitev in kdaj. Če želite zamenjati datoteko za obstoječo povezavo, ne da bi spremenili URL:
linkdash links update board-deck --file ./board-deck-v2.pdf
Določite, kdo lahko odpre povezavo
Vsaka povezava ima lahko svoja pravila dostopa:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordod obiskovalcev zahteva geslo, preden se povezava odpre.--startsin--expiressprejmeta trajanje, kot je30m,24hali7d, ali datum ISO. Pred začetnim časom se povezava sploh ne razreši.--max-openingspovezavo zaustavi po tolikšnem številu odprtij, kar je uporabno za enkratne prenose.
Povezavo lahko kadar koli zaustavite in znova aktivirate z linkdash links update q4-deck --status paused in --status active.
Izvedite A/B-test kratke povezave
V Linkdashu je vsaka povezava vsebnik ene ali več različic. Različica je cilj (URL, datoteka ali besedilo) z lastno utežjo in pravili. Navadna povezava ima eno samo različico z imenom main. Dodajte jih več in kratka povezava razdeli promet med njimi:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Zastavice za vsakim --variant pripadajo tej različici do naslednje. Promet se razdeli po uteži, ki je privzeto 1, zato je zgornji primer test 50/50. Različici dajte --weight 3, da ji pošljete trikrat več prometa.
Dodelitev je privzeto stalna: obiskovalec, ki se vrača, dobiva isto različico, kar je pri poštenem testu tudi želeno. Ko eksperiment spremenite, linkdash links update launch --restart-split enkrat na novo premeša vse.

Statistika je na voljo po različicah, zato jih lahko neposredno primerjate:
linkdash links stats launch --last 7d
Polje variants v izpisu za vsako različico poroča visits, visitors, downloads in plays. Več o statistiki spodaj.
Usmerjajte obiskovalce po državi, napravi ali parametru poizvedbe
Različice imajo lahko tudi pogoje. Različici dodajte --when in dobijo jo lahko samo obiskovalci, ki ustrezajo pogoju. Tako ena kratka povezava postane usmerjevalnik. Na primer povezava, ki telefone pošlje v pravo trgovino z aplikacijami:
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
Ko obiskovalec odpre povezavo, različice, katerih pogoji se ujemajo, tvorijo nabor. Če se ne ujema nobena, se uporabijo različice brez pogojev, zato zgornja web ujame vse, ki niso na iOS ali Androidu.

Ujemate lahko po:
| Ključ | Ujema se z | Primer |
|---|---|---|
country |
Kode držav 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 |
Jezikovne oznake, po predponi | --when language=de |
referrer |
Gostitelj napotitve | --when referrer=twitter.com |
Ponovite --when, da hkrati zahtevate več pogojev. --when country=DE,AT --when device=mobile se ujema z mobilnimi obiskovalci iz Nemčije ali Avstrije.
Različice se lahko ujemajo tudi z obiskovalčevim nizom poizvedbe, zato se ena povezava lahko vede različno glede na to, kje ste jo delili. lida.sh/launch?src=newsletter lahko bralce e-novic pošlje na posebno mesto:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Pravila za parametre podpirajo enako (=), ni enako (!=), vsebuje (~=), se začne z (^=), se konča z ($=), je eno od (=a|b), obstaja (param:ref?) in manjka (param:!ref). Če želite obiskovalčeve parametre namesto tega posredovati cilju, povezavo ustvarite z --forward-params.
Nadzorna plošča ima enake kontrolnike, z izbirnikom držav, ki išče po imenu, zato si vam ni treba zapomniti, da je Slovenija SI:

Analitika klikov v terminalu
linkdash links stats launch --last 7d
Izpis vsebuje skupno število visits, downloads in plays, število obiskov v zahtevanem obdobju (visitsInLast), countries in referrers, iz katerih so obiski prišli, razčlenitev variants in seznam visitors s časom, državo, napravo, brskalnikom in napotiteljem vsakega nedavnega obiska. --last sprejme trajanje, kot je 24h ali 30d, privzeto pa je 24h.
Linkdash ne shranjuje naslovov IP obiskovalcev. Naslov se uporabi za določitev obiskovalčeve države in za izpeljavo anonimnega identifikatorja obiskovalca, ki se spreminja vsak dan, nato pa se zavrže.
Če želite na klike odzvati sproti, registrirajte webhook. Linkdash na katero koli končno točko HTTPS pošilja podpisane dogodke link.visit, link.download in link.play:
linkdash webhooks create --url https://example.com/hooks
Skrivnost za podpisovanje se izpiše samo enkrat, zato jo takoj shranite. Kako preverjati podpise, preberite v dokumentaciji o webhookih.
Agenti UI ustvarjajo kratke povezave prek MCP
Vse zgoraj je na voljo tudi agentom UI. Linkdash poganja oddaljeni strežnik MCP na https://api.linkdash.dev/mcp, njegova orodja pa zrcalijo CLI: links_create, links_update, links_stats, variants_add, domains_add in druga, ki vračajo enak JSON.
Na nadzorni plošči v razdelku Ključi API ustvarite ključ API, nato povežite agenta. V Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
V Cursorju ga dodajte v .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
V Codexu, ki ključ prebere iz okoljske spremenljivke, ki jo navedete:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Od takrat naprej lahko povezave zahtevate v navadnem jeziku, na primer „skrajšaj https://example.com/pricing kot pricing in ji dodaj oznako launch“ ali „katera različica povezave launch je ta teden dobila več obiskovalcev?“, agent pa pokliče pravo orodje. Dokumentacija MCP opisuje tudi OpenCode.
Če vaš agent že dela v terminalu, lahko CLI uporablja neposredno. Namestite skill Linkdash za agente, da bo poznal ukaze in zastavice:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Uporabite HTTP API
Za vašo lastno kodo so iste operacije na voljo kot preprost REST API na https://api.linkdash.dev/v1, z avtentikacijo z istim ključem 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" }'
Odgovor ima enako obliko kot izpis CLI. Referenca API opisuje vse končne točke, vključno z nalaganjem datotek in različicami.
Uporabite svojo domeno
Kratke povezave so privzeto na lida.sh. Če jih želite ponuditi na svoji domeni, jo dodajte in DNS usmerite na Linkdash:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Nato na njej ustvarjajte povezave z --domain go.example.com. Vsaka lastna domena ima svoj nabor slugov, zato go.example.com/launch ne trči z launch nikogar drugega. Vodnik o domenah opisuje nastavitev DNS, vključno z nastavitvijo z enim klikom pri ponudnikih, ki jo podpirajo.
Cene
Paket Free ne zahteva kreditne kartice in vključuje 5.000 dogodkov na mesec, 1 GB prostora za datoteke, en mesec zgodovine analitike in eno lastno domeno. Dogodek je obisk, prenos ali predvajanje na eni od vaših povezav ali zapis, kot je ustvarjanje ali posodobitev povezave. Branja, kot sta izpis povezav ali pridobivanje statistike, so brezplačna.
Plačljivi paketi te omejitve povečajo: Professional stane 18 $ na mesec, Growth pa 48 $ na mesec. Celotno primerjavo najdete v cenah.
Pogosta vprašanja
Ali obstaja brezplačen skrajševalnik URL-jev s CLI?
Da. Linkdash CLI deluje v paketu Free, ki vključuje 5.000 dogodkov na mesec brez kreditne kartice.
Lahko Linkdash CLI uporabljam v CI?
Da. LINKDASH_TOKEN nastavite na žeton seje in CLI deluje brez brskalnika. Ker vsak ukaz izpiše JSON, lahko povezave ustvarjate in posodabljate iz GitHub Actions ali katerega koli drugega cevovoda in rezultate berete z jq.
Ali lahko agenti UI ustvarjajo kratke povezave?
Da, na tri načine: prek strežnika MCP na https://api.linkdash.dev/mcp, prek CLI z nameščenim skillom Linkdash za agente ali prek HTTP API. Vsi trije ponujajo iste operacije in vračajo enak JSON.
Ali Linkdash shranjuje naslove IP obiskovalcev?
Ne. Linkdash naslov uporabi za določitev obiskovalčeve države in za ustvarjanje dnevnega anonimnega identifikatorja, nato ga zavrže. Lastniki povezav naslovov IP nikoli ne vidijo.
Ali lahko ena kratka povezava različne obiskovalce pošlje na različne strani?
Da. Povezavi dajte več različic in vsaki dodajte pogoje, kot so država, naprava, operacijski sistem, jezik, napotitelj ali parameter poizvedbe. Brez pogojev različice promet razdelijo po uteži, kar je način za izvedbo A/B-testa.
Ste pripravljeni na preizkus? Namestite CLI, zaženite linkdash auth create in prvo povezavo skrajšajte v manj kot minuti. Hiter začetek vsebuje vse korake.

