climcpapi
Un URL shortener cu CLI pentru developeri și agenți AI
Scurtează URL-uri din terminal cu Linkdash CLI. Partajează fișiere și fragmente, rulează teste A/B, targetează vizitatori și conectează agenți AI prin MCP.
Igor Kirnosov9 min de lectură

Linkdash este un URL shortener pe care îl controlezi din terminal. O singură comandă transformă un URL, un fișier sau un fragment de text într-un link scurt urmărit pe lida.sh și afișează rezultatul ca JSON, pe care îl poți trimite prin pipe oriunde. Aceleași operațiuni sunt disponibile printr-un HTTP API și ca server MCP, așa că un agent AI poate crea, actualiza și măsura linkuri cu exact aceleași unelte pe care le folosești tu.
Ghidul acesta parcurge tot CLI-ul: instalarea, scurtarea primului link, partajarea fișierelor, protejarea linkurilor, testele A/B, rutarea vizitatorilor după țară sau dispozitiv și citirea statisticilor fără să deschizi browserul.

Instalează Linkdash CLI
CLI-ul este un pachet npm și are nevoie de Node.js 20 sau mai nou.
npm i -g linkdash-cli
Funcționează la fel cu pnpm add -g linkdash-cli sau bun add -g linkdash-cli. Comanda instalată este linkdash.
Apoi creează un cont și conectează CLI-ul, într-un singur pas:
linkdash auth create
Comanda deschide pagina de înregistrare în browser. După ce ai contul, aprobi codul afișat în terminal și CLI-ul este conectat. Dacă ai deja un cont, folosește linkdash auth login. linkdash auth whoami confirmă ce cont folosești, iar referința CLI listează fiecare comandă și fiecare flag.
Sesiunea este salvată în ~/.config/linkdash/config.json, cu permisiuni doar pentru proprietar. Pentru CI sau alte medii fără interfață, setează LINKDASH_TOKEN la tokenul de sesiune din acel fișier, de pe o mașină pe care te-ai conectat, și tratează-l ca pe orice alt secret.
Scurtează un URL din linia de comandă
linkdash links create --url https://example.com/pricing --slug pricing
{
"id": "pricing",
"url": "https://lida.sh/pricing",
"kind": "url",
"variants": [
{ "name": "main", "kind": "url" }
]
}
Asta e toată interfața: comenzile reușite afișează JSON pe stdout, iar erorile afișează text simplu pe stderr, cu exit code 1. Nu există flagul --json, pentru că JSON este singurul format de ieșire. Asta face CLI-ul ușor de folosit în scripturi. Ca să copiezi un link scurt nou direct în clipboard pe macOS:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Câteva flaguri pe care le vei folosi mereu:
--slugsetează calea publică. Slug-urile folosesc litere mici, cifre și cratime în interior, până la 64 de caractere. Dacă îl omiți, Linkdash generează unul.--nameeste o etichetă privată pe care o vezi doar tu, utilă ca să găsești linkurile mai târziu.--tagse poate repeta, așa că--tag launch --tag q4pune două etichete pe un link.--utm-source,--utm-medium,--utm-campaign,--utm-termși--utm-contentadaugă parametri de campanie la destinație.
Listează și caută ce ai creat cu linkdash links list --q pricing --tag launch.
Partajează un fișier sau un fragment de text
Linkurile scurte nu sunt doar pentru URL-uri. Aceeași comandă încarcă un fișier sau salvează un fragment:
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
Un link de fișier le oferă vizitatorilor o descărcare, cu previzualizare pentru imagini și video. Un link de text afișează fragmentul pe o pagină cu un buton de copiere. Ambele sunt urmărite ca orice alt link, așa că poți vedea cine ți-a deschis prezentarea și când. Ca să înlocuiești fișierul din spatele unui link existent fără să schimbi URL-ul:
linkdash links update board-deck --file ./board-deck-v2.pdf
Controlează cine poate deschide un link
Fiecare link poate avea propriile reguli de acces:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordle cere vizitatorilor o parolă înainte să se deschidă linkul.--startsși--expiresprimesc o durată, cum ar fi30m,24hsau7d, ori o dată ISO. Înainte de ora de start, linkul nu se rezolvă deloc.--max-openingsîntrerupe linkul după acel număr de deschideri, util pentru descărcări unice.
Poți întrerupe și relua un link oricând cu linkdash links update q4-deck --status paused și --status active.
Rulează un test A/B pe un link scurt
În Linkdash, fiecare link este un container cu una sau mai multe variante. O variantă este o destinație (un URL, un fișier sau un text) cu propria pondere și propriile reguli. Un link obișnuit are o singură variantă, numită main. Adaugă mai multe și linkul scurt își împarte traficul între ele:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Flagurile de după fiecare --variant aparțin acelei variante până la următoarea. Traficul se împarte după pondere, care implicit este 1, așa că exemplul de mai sus este un test 50/50. Dă-i unei variante --weight 3 ca să-i trimiți de trei ori mai mult trafic.
Atribuirea este fixă implicit: un vizitator care revine primește mereu aceeași variantă, exact ce vrei pentru un test corect. Când schimbi experimentul, linkdash links update launch --restart-split îi redistribuie pe toți o singură dată.

Statisticile vin pe fiecare variantă, așa că le poți compara direct:
linkdash links stats launch --last 7d
Array-ul variants din rezultat raportează visits, visitors, downloads și plays pentru fiecare variantă. Mai multe despre statistici mai jos.
Rutează vizitatorii după țară, dispozitiv sau parametru de query
Variantele pot avea și condiții. Adaugă --when la o variantă și doar vizitatorii care se potrivesc o pot primi. Așa, un singur link scurt devine un router. De exemplu, un link care trimite telefoanele în magazinul de aplicații potrivit:
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
Când un vizitator deschide linkul, variantele ale căror condiții se potrivesc formează setul de candidați. Dacă nu se potrivește niciuna, se folosesc variantele fără condiții, așa că web de mai sus îi prinde pe toți cei care nu sunt pe iOS sau Android.

Poți filtra după:
| Cheie | Se potrivește cu | Exemplu |
|---|---|---|
country |
Coduri ISO de țară | --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 |
Taguri de limbă, după prefix | --when language=de |
referrer |
Hostul de referință | --when referrer=twitter.com |
Repetă --when ca să ceri mai multe condiții deodată. --when country=DE,AT --when device=mobile se potrivește cu vizitatorii pe mobil din Germania sau Austria.
Variantele se pot potrivi și cu query string-ul vizitatorului, așa că un singur link se poate comporta diferit în funcție de locul unde l-ai partajat. lida.sh/launch?src=newsletter îi poate trimite pe cititorii newsletterului într-un loc special:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Regulile pentru parametri suportă egal (=), diferit (!=), conține (~=), începe cu (^=), se termină cu ($=), unul dintre (=a|b), prezent (param:ref?) și lipsă (param:!ref). Dacă vrei ca parametrii vizitatorului să fie transmiși mai departe către destinație, creează linkul cu --forward-params.
Panoul are aceleași controale, cu un selector de țări care caută după nume, ca să nu trebuiască să ții minte că Slovenia este SI:

Citește statisticile de clicuri din terminal
linkdash links stats launch --last 7d
Rezultatul include totalurile visits, downloads și plays, numărul de vizite din intervalul cerut (visitsInLast), țările (countries) și referrerii (referrers) din care au venit vizitele, defalcarea pe variants și o listă visitors cu ora, țara, dispozitivul, browserul și referrerul fiecărei vizite recente. --last primește o durată, cum ar fi 24h sau 30d, iar implicit este 24h.
Linkdash nu stochează adresele IP ale vizitatorilor. Adresa este folosită ca să afle țara vizitatorului și ca să derive un identificator anonim de vizitator, care se schimbă zilnic, apoi este eliminată.
Ca să reacționezi la clicuri pe loc, înregistrează un webhook. Linkdash trimite evenimente semnate link.visit, link.download și link.play către orice endpoint HTTPS:
linkdash webhooks create --url https://example.com/hooks
Secretul de semnare este afișat o singură dată, așa că salvează-l imediat. Vezi documentația despre webhookuri pentru verificarea semnăturilor.
Lasă agenții AI să creeze linkuri scurte prin MCP
Tot ce e mai sus este disponibil și pentru agenții AI. Linkdash rulează un server MCP remote la https://api.linkdash.dev/mcp, iar uneltele lui oglindesc CLI-ul: links_create, links_update, links_stats, variants_add, domains_add și restul, care returnează același JSON.
Creează o cheie API în panou, la Chei API, apoi conectează-ți agentul. În Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
În Cursor, adaugă-l în .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
În Codex, care citește cheia din variabila de mediu pe care o indici:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
De acum poți cere linkuri în limbaj natural, de exemplu „scurtează https://example.com/pricing ca pricing și pune-i eticheta launch” sau „care variantă a lui launch a avut mai mulți vizitatori săptămâna asta?”, iar agentul apelează unealta potrivită. Documentația MCP acoperă și OpenCode.
Dacă agentul tău lucrează deja într-un terminal, poate folosi direct CLI-ul. Instalează skillul de agent Linkdash ca să cunoască comenzile și flagurile:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Folosește HTTP API
Pentru propriul tău cod, aceleași operațiuni sunt un REST API simplu la https://api.linkdash.dev/v1, autentificat cu aceeași cheie 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" }'
Răspunsul are aceeași formă ca rezultatul CLI-ului. Referința API acoperă fiecare endpoint, inclusiv încărcările de fișiere și variantele.
Folosește propriul domeniu
Implicit, linkurile scurte stau pe lida.sh. Ca să le servești de pe propriul domeniu, adaugă-l și îndreaptă DNS-ul către Linkdash:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Apoi creează linkuri pe el cu --domain go.example.com. Fiecare domeniu personalizat are propriul set de slug-uri, așa că go.example.com/launch nu intră în conflict cu launch-ul nimănui altcuiva. Ghidul despre domenii acoperă configurarea DNS, inclusiv configurarea dintr-un clic pentru furnizorii care o suportă.
Prețuri
Planul Free nu cere card de credit și include 5.000 de evenimente pe lună, 1 GB de stocare pentru fișiere, o lună de istoric de statistici și un domeniu personalizat. Un eveniment este o vizită, o descărcare sau o redare pe unul dintre linkurile tale, ori o scriere, cum ar fi crearea sau actualizarea unui link. Citirile, cum ar fi listarea linkurilor sau extragerea statisticilor, sunt gratuite.
Planurile plătite ridică aceste limite: Professional costă 18 USD pe lună, iar Growth 48 USD pe lună. Vezi prețurile pentru comparația completă.
Întrebări frecvente
Există un URL shortener gratuit cu CLI?
Da. Linkdash CLI funcționează în planul Free, care include 5.000 de evenimente pe lună, fără card de credit.
Pot folosi Linkdash CLI în CI?
Da. Setează LINKDASH_TOKEN la un token de sesiune și CLI-ul rulează fără browser. Pentru că fiecare comandă afișează JSON, poți crea și actualiza linkuri din GitHub Actions sau din orice alt pipeline și poți citi rezultatele cu jq.
Pot agenții AI să creeze linkuri scurte?
Da, în trei moduri: prin serverul MCP de la https://api.linkdash.dev/mcp, prin CLI cu skillul de agent Linkdash instalat sau prin HTTP API. Toate trei expun aceleași operațiuni și returnează același JSON.
Stochează Linkdash adresele IP ale vizitatorilor?
Nu. Linkdash folosește adresa ca să afle țara vizitatorului și ca să creeze un identificator anonim zilnic, apoi o elimină. Proprietarii linkurilor nu văd niciodată adrese IP.
Poate un singur link scurt să trimită vizitatori diferiți pe pagini diferite?
Da. Dă-i unui link mai multe variante și adaugă fiecăreia condiții precum țara, dispozitivul, sistemul de operare, limba, referrerul sau un parametru de query. Fără condiții, variantele împart traficul după pondere, iar așa rulezi un test A/B.
Vrei să-l încerci? Instalează CLI-ul, rulează linkdash auth create și scurtează-ți primul link în mai puțin de un minut. Ghidul de pornire rapidă are toți pașii.

