Preskoči na vsebino
Vse objave

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

Terminal, ki z ukazom linkdash links create ustvari kratko povezavo Linkdash

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.

Nadzorna plošča Linkdash s seznamom kratkih povezav z vrsto, slugom, ciljem in stanjem

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:

  • --slug nastavi javno pot. Slugi uporabljajo male črke, številke in notranje vezaje, do 64 znakov. Če ga izpustite, ga Linkdash ustvari sam.
  • --name je zasebna oznaka, ki jo vidite samo vi, priročna za poznejše iskanje povezav.
  • --tag lahko ponovite, zato --tag launch --tag q4 povezavi doda dve oznaki.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term in --utm-content ciljnemu 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
  • --password od obiskovalcev zahteva geslo, preden se povezava odpre.
  • --starts in --expires sprejmeta trajanje, kot je 30m, 24h ali 7d, ali datum ISO. Pred začetnim časom se povezava sploh ne razreši.
  • --max-openings povezavo 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.

Povezava Linkdash z dvema različicama, control in annual-first, ki promet razdeli med dve strani s cenami

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.

Povezava Linkdash, ki obiskovalce v iOS usmeri v App Store, v Androidu v Google Play, vse druge pa na spletno stran

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:

Izbira ciljnih držav za različico na nadzorni plošči Linkdash, z izbranima Nemčijo in Avstrijo

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.