Sari la conținut
Toate articolele

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ă

Terminal care creează un link scurt Linkdash cu comanda linkdash links create

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.

Panoul Linkdash cu o listă de linkuri scurte, cu tipul, slug-ul, destinația și statusul fiecăruia

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:

  • --slug setează 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.
  • --name este o etichetă privată pe care o vezi doar tu, utilă ca să găsești linkurile mai târziu.
  • --tag se poate repeta, așa că --tag launch --tag q4 pune două etichete pe un link.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term și --utm-content adaugă 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

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
  • --password le cere vizitatorilor o parolă înainte să se deschidă linkul.
  • --starts și --expires primesc o durată, cum ar fi 30m, 24h sau 7d, 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.

Î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ă.

Un link Linkdash cu două variante, control și annual-first, care împarte traficul între două pagini de prețuri

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.

Un link Linkdash care trimite vizitatorii în App Store pe iOS, în Google Play pe Android și pe o pagină web pe toți ceilalți

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:

Alegerea țărilor țintă pentru o variantă în panoul Linkdash, cu Germania și Austria selectate

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.

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.