climcpapi
CLI za skraćivanje URL-ova za developere i AI agente
Skraćujte URL-ove iz naredbenog retka s CLI-jem Linkdash. Dijelite datoteke i isječke, radite A/B testove, ciljajte posjetitelje i upravljajte putem MCP-a.
Igor Kirnosov9 min čitanja

Linkdash je skraćivač URL-ova kojim upravljate iz terminala. Jedna naredba pretvara URL, datoteku ili isječak teksta u praćenu kratku poveznicu na lida.sh i ispisuje rezultat kao JSON koji možete proslijediti bilo kamo. Iste operacije dostupne su putem HTTP API-ja i kao MCP poslužitelj, pa AI agent može izrađivati, ažurirati i mjeriti poveznice potpuno istim alatima koje koristite vi.
Ovaj vodič prolazi kroz cijeli CLI: instalaciju, skraćivanje prve poveznice, dijeljenje datoteka, zaključavanje poveznica, A/B testove, usmjeravanje posjetitelja po državi ili uređaju i čitanje analitike bez otvaranja preglednika.

Instalirajte CLI Linkdash
CLI je npm paket i treba Node.js 20 ili noviji.
npm i -g linkdash-cli
Jednako radi s pnpm add -g linkdash-cli ili bun add -g linkdash-cli. Naredba koju instalira je linkdash.
Zatim u jednom koraku izradite račun i prijavite CLI:
linkdash auth create
Time se u pregledniku otvara stranica za registraciju. Kad imate račun, odobrite kod prikazan u terminalu i CLI je prijavljen. Ako već imate račun, umjesto toga koristite linkdash auth login. linkdash auth whoami potvrđuje koji račun koristite, a referentni opis CLI-ja navodi sve naredbe i zastavice.
Sesija se pohranjuje u ~/.config/linkdash/config.json s dozvolama samo za vlasnika. Za CI ili druga okruženja bez sučelja postavite LINKDASH_TOKEN na token sesije iz te datoteke s računala na kojem ste prijavljeni i čuvajte ga kao svaku drugu tajnu.
Skratite URL iz naredbenog retka
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 cijelo sučelje: uspješne naredbe ispisuju JSON na stdout, a pogreške ispisuju običan tekst na stderr s izlaznim kodom 1. Zastavice --json nema jer je JSON jedini izlaz. Zato je CLI lako koristiti u skriptama. Da biste novu kratku poveznicu na macOS-u kopirali izravno u međuspremnik:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Nekoliko zastavica koje ćete stalno koristiti:
--slugpostavlja javnu putanju. Slugovi koriste mala slova, znamenke i crtice unutar riječi, do 64 znaka. Ako ga izostavite, Linkdash ga generira.--nameje privatna oznaka koju vidite samo vi, korisna za kasnije pronalaženje poveznica.--tagse može ponavljati, pa--tag launch --tag q4poveznici dodaje dvije oznake.--utm-source,--utm-medium,--utm-campaign,--utm-termi--utm-contentdodaju parametre kampanje odredištu.
Ono što ste izradili ispišite i pretražite naredbom linkdash links list --q pricing --tag launch.
Podijelite datoteku ili isječak teksta
Kratke poveznice nisu samo za URL-ove. Ista naredba prenosi datoteku ili sprema isječak:
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
Poveznica na datoteku posjetiteljima nudi preuzimanje, s pregledom za slike i videozapise. Poveznica na tekst prikazuje isječak na stranici s gumbom za kopiranje. Obje se prate kao i svaka druga poveznica, pa možete vidjeti tko je i kada otvorio vašu prezentaciju. Da biste zamijenili datoteku iza postojeće poveznice bez promjene URL-a:
linkdash links update board-deck --file ./board-deck-v2.pdf
Odredite tko može otvoriti poveznicu
Svaka poveznica može imati vlastita pravila pristupa:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordod posjetitelja traži lozinku prije otvaranja poveznice.--startsi--expiresprimaju trajanje poput30m,24hili7dili datum u formatu ISO. Prije početka poveznica se uopće ne razrješava.--max-openingspauzira poveznicu nakon zadanog broja otvaranja, što je korisno za jednokratna preuzimanja.
Poveznicu možete u bilo kojem trenutku pauzirati i ponovno pokrenuti naredbama linkdash links update q4-deck --status paused i --status active.
Napravite A/B test na kratkoj poveznici
U Linkdashu je svaka poveznica spremnik jedne ili više varijanti. Varijanta je odredište (URL, datoteka ili tekst) s vlastitom težinom i pravilima. Obična poveznica ima jednu varijantu s nazivom main. Dodajte još i kratka poveznica dijeli promet među njima:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Zastavice nakon svakog --variant pripadaju toj varijanti do sljedeće. Promet se dijeli prema težini, koja je zadano 1, pa je gornji primjer test 50/50. Dajte varijanti --weight 3 da biste joj poslali tri puta više prometa.
Dodjela je prema zadanim postavkama stalna: posjetitelj koji se vraća i dalje dobiva istu varijantu, što i želite za pošten test. Kad promijenite eksperiment, linkdash links update launch --restart-split jednom ponovno raspoređuje sve.

Statistika stiže po varijanti, pa ih možete izravno usporediti:
linkdash links stats launch --last 7d
Polje variants u izlazu navodi visits, visitors, downloads i plays za svaku varijantu. Više o statistici u nastavku.
Usmjerite posjetitelje po državi, uređaju ili parametru upita
Varijante mogu imati i uvjete. Dodajte varijanti --when i dobit će je samo posjetitelji koji odgovaraju. Tako jedna kratka poveznica postaje usmjerivač. Na primjer, jedna poveznica koja mobitele šalje u pravu trgovinu aplikacijama:
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
Kad posjetitelj otvori poveznicu, varijante čiji uvjeti odgovaraju čine skup za odabir. Ako nijedna ne odgovara, koriste se varijante bez uvjeta, pa gornji web hvata sve koji nisu na iOS-u ili Androidu.

Uvjeti mogu odgovarati sljedećem:
| Ključ | Odgovara | Primjer |
|---|---|---|
country |
ISO kodovi država | --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 |
Oznake jezika, po prefiksu | --when language=de |
referrer |
Host s kojeg posjetitelj dolazi | --when referrer=twitter.com |
Ponovite --when da biste zahtijevali više uvjeta odjednom. --when country=DE,AT --when device=mobile odgovara posjetiteljima s mobitela iz Njemačke ili Austrije.
Varijante mogu odgovarati i posjetiteljevu nizu upita, pa se jedna poveznica može ponašati različito ovisno o tome gdje ste je podijelili. lida.sh/launch?src=newsletter može čitatelje newslettera poslati na posebno mjesto:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Pravila za parametre podržavaju jednako (=), nije jednako (!=), sadrži (~=), počinje s (^=), završava s ($=), jedno od (=a|b), postoji (param:ref?) i nedostaje (param:!ref). Ako umjesto toga želite posjetiteljeve parametre proslijediti na odredište, izradite poveznicu sa --forward-params.
Nadzorna ploča ima iste kontrole, s odabirom država koji pretražuje po nazivu, pa ne morate pamtiti da je Slovenija SI:

Čitajte analitiku klikova iz terminala
linkdash links stats launch --last 7d
Izlaz sadrži ukupne visits, downloads i plays, broj posjeta u traženom razdoblju (visitsInLast), države (countries) i izvore (referrers) iz kojih su ti posjeti došli, raščlambu po varijantama (variants) i popis visitors s vremenom, državom, uređajem, preglednikom i izvorom svakog nedavnog posjeta. --last prima trajanje poput 24h ili 30d, a zadano je 24h.
Linkdash ne pohranjuje IP adrese posjetitelja. Adresa se koristi za utvrđivanje posjetiteljeve države i za izvođenje anonimnog identifikatora posjetitelja koji se mijenja svaki dan, a zatim se odbacuje.
Da biste reagirali na klikove čim se dogode, registrirajte webhook. Linkdash šalje potpisane događaje link.visit, link.download i link.play na bilo koju HTTPS krajnju točku:
linkdash webhooks create --url https://example.com/hooks
Tajni ključ za potpisivanje ispisuje se samo jednom, pa ga odmah spremite. Kako provjeriti potpise, pročitajte u dokumentaciji o webhookovima.
Neka AI agenti izrađuju kratke poveznice putem MCP-a
Sve navedeno dostupno je i AI agentima. Linkdash pokreće udaljeni MCP poslužitelj na https://api.linkdash.dev/mcp, a njegovi alati odgovaraju CLI-ju: links_create, links_update, links_stats, variants_add, domains_add i ostali, i vraćaju isti JSON.
Izradite API ključ na nadzornoj ploči u odjeljku API ključevi, a zatim povežite svojeg agenta. U Claude Codeu:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
U Cursoru ga dodajte u .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
U Codexu, koji ključ čita iz varijable okruženja koju navedete:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Od tada poveznice možete tražiti običnim jezikom, npr. „skrati https://example.com/pricing kao pricing i označi ga s launch” ili „koja je varijanta poveznice launch ovaj tjedan dobila više posjetitelja?”, a agent poziva pravi alat. Dokumentacija o MCP-u pokriva i OpenCode.
Ako vaš agent već radi u terminalu, može izravno koristiti CLI. Instalirajte Linkdashov skill za agente kako bi poznavao naredbe i zastavice:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Koristite HTTP API
Za vaš vlastiti kod iste su operacije dostupne kao običan REST API na https://api.linkdash.dev/v1, uz autentifikaciju istim API ključ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" }'
Odgovor ima isti oblik kao izlaz CLI-ja. Referentni opis API-ja pokriva sve krajnje točke, uključujući prijenos datoteka i varijante.
Koristite vlastitu domenu
Kratke poveznice prema zadanim postavkama nalaze se na lida.sh. Da biste ih posluživali s vlastite domene, dodajte je i usmjerite svoj DNS na Linkdash:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Zatim na njoj izrađujte poveznice sa --domain go.example.com. Svaka vlastita domena ima vlastiti skup slugova, pa se go.example.com/launch ne sukobljava s tuđim launch. Vodič za domene pokriva postavljanje DNS-a, uključujući postavljanje jednim klikom za pružatelje koji to podržavaju.
Cijene
Za paket Free nije potrebna kreditna kartica, a uključuje 5.000 događaja mjesečno, 1 GB prostora za datoteke, jedan mjesec povijesti analitike i jednu vlastitu domenu. Događaj je posjet, preuzimanje ili reprodukcija na jednoj od vaših poveznica ili zapisivanje poput izrade ili ažuriranja poveznice. Čitanja, poput ispisa poveznica ili dohvaćanja statistike, besplatna su.
Plaćeni paketi povećavaju ta ograničenja: Professional stoji 18 $ mjesečno, a Growth 48 $ mjesečno. Potpunu usporedbu pogledajte na stranici cijena.
Česta pitanja
Postoji li besplatan skraćivač URL-ova s CLI-jem?
Da. CLI Linkdash radi u paketu Free, koji uključuje 5.000 događaja mjesečno bez kreditne kartice.
Mogu li CLI Linkdash koristiti u CI-ju?
Da. Postavite LINKDASH_TOKEN na token sesije i CLI radi bez preglednika. Budući da svaka naredba ispisuje JSON, poveznice možete izrađivati i ažurirati iz GitHub Actionsa ili bilo kojeg drugog pipelinea i čitati rezultate s jq.
Mogu li AI agenti izrađivati kratke poveznice?
Da, na tri načina: putem MCP poslužitelja na https://api.linkdash.dev/mcp, putem CLI-ja s instaliranim Linkdashovim skillom za agente ili putem HTTP API-ja. Sva tri nude iste operacije i vraćaju isti JSON.
Pohranjuje li Linkdash IP adrese posjetitelja?
Ne. Linkdash adresu koristi za utvrđivanje posjetiteljeve države i za izradu dnevnog anonimnog identifikatora, a zatim je odbacuje. Vlasnici poveznica nikad ne vide IP adrese.
Može li jedna kratka poveznica slati različite posjetitelje na različite stranice?
Da. Dajte poveznici nekoliko varijanti i svakoj dodajte uvjete poput države, uređaja, operacijskog sustava, jezika, izvora ili parametra upita. Bez uvjeta varijante dijele promet prema težini, i tako se radi A/B test.
Spremni ste isprobati? Instalirajte CLI, pokrenite linkdash auth create i skratite svoju prvu poveznicu za manje od minute. Brzi početak sadrži sve korake.

