Pereiti prie turinio
Visi įrašai

climcpapi

Nuorodų trumpinimo CLI programuotojams ir DI agentams

Trumpinkite URL iš komandinės eilutės su Linkdash CLI. Bendrinkite failus, vykdykite A/B testus, taikykite lankytojams ir valdykite nuorodas per MCP.

Igor Kirnosov8 min. skaitymo

Terminalas, kuriame komanda linkdash links create kuria Linkdash trumpąją nuorodą

Linkdash — tai nuorodų trumpintuvas, kurį valdote iš terminalo. Viena komanda paverčia URL, failą ar teksto fragmentą sekama trumpąja nuoroda lida.sh domene ir išveda rezultatą kaip JSON, kurį galite perduoti bet kur. Tos pačios operacijos pasiekiamos per HTTP API ir kaip MCP serveris, todėl DI agentas gali kurti, atnaujinti ir matuoti nuorodas lygiai tais pačiais įrankiais kaip ir jūs.

Šiame vadove apžvelgiama visa CLI: kaip ją įdiegti, sutrumpinti pirmąją nuorodą, bendrinti failus, apriboti prieigą prie nuorodų, vykdyti A/B testus, nukreipti lankytojus pagal šalį ar įrenginį ir skaityti analitiką neatidarius naršyklės.

Linkdash valdymo skydelis su trumpųjų nuorodų sąrašu: tipas, slug, paskirtis ir būsena

Linkdash CLI diegimas

CLI yra npm paketas, jai reikia Node.js 20 ar naujesnės versijos.

npm i -g linkdash-cli

Taip pat veikia pnpm add -g linkdash-cli arba bun add -g linkdash-cli. Įdiegiama komanda vadinasi linkdash.

Tada vienu žingsniu susikurkite paskyrą ir prijunkite CLI:

linkdash auth create

Naršyklėje atsidarys registracijos puslapis. Susikūrę paskyrą patvirtinkite terminale rodomą kodą, ir CLI bus prisijungusi. Jei paskyrą jau turite, vietoj to naudokite linkdash auth login. linkdash auth whoami parodo, kuria paskyra naudojatės, o CLI žinyne išvardytos visos komandos ir parametrai.

Sesija saugoma faile ~/.config/linkdash/config.json, kurį gali skaityti tik savininkas. CI ar kitose aplinkose be ekrano nustatykite LINKDASH_TOKEN reikšmę — sesijos žetoną iš to failo kompiuteryje, kuriame esate prisijungę, ir saugokite jį kaip bet kurią kitą paslaptį.

URL trumpinimas iš komandinės eilutės

linkdash links create --url https://example.com/pricing --slug pricing
{
  "id": "pricing",
  "url": "https://lida.sh/pricing",
  "kind": "url",
  "variants": [
    { "name": "main", "kind": "url" }
  ]
}

Štai ir visa sąsaja: sėkmingos komandos išveda JSON į stdout, o klaidos išvedamos paprastu tekstu į stderr su išėjimo kodu 1. Parametro --json nėra, nes JSON yra vienintelis išvesties formatas. Dėl to CLI lengva naudoti skriptuose. Kaip macOS sistemoje naują trumpąją nuorodą nukopijuoti tiesiai į iškarpinę:

linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy

Keli parametrai, kuriuos naudosite nuolat:

  • --slug nustato viešąjį kelią. Slug sudaro mažosios raidės, skaitmenys ir brūkšneliai viduryje, iki 64 simbolių. Jei jo nenurodysite, Linkdash sugeneruos.
  • --name — privati etiketė, kurią matote tik jūs; patogu vėliau ieškant nuorodų.
  • --tag galima kartoti, todėl --tag launch --tag q4 nuorodai priskiria dvi žymas.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term ir --utm-content prideda prie paskirties kampanijos parametrus.

Tai, ką sukūrėte, išvardykite ir ieškokite su linkdash links list --q pricing --tag launch.

Failo ar teksto fragmento bendrinimas

Trumposios nuorodos skirtos ne tik URL. Ta pati komanda įkelia failą arba išsaugo 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

Failo nuoroda lankytojams leidžia atsisiųsti failą, o paveikslėliams ir vaizdo įrašams rodoma peržiūra. Teksto nuoroda rodo fragmentą puslapyje su kopijavimo mygtuku. Abi sekamos kaip bet kuri kita nuoroda, todėl matysite, kas ir kada atidarė jūsų pristatymą. Kaip pakeisti failą esamoje nuorodoje nekeičiant URL:

linkdash links update board-deck --file ./board-deck-v2.pdf

Kas gali atidaryti nuorodą

Kiekviena nuoroda gali turėti savo prieigos taisykles:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • --password prieš atidarant nuorodą paprašo lankytojų slaptažodžio.
  • --starts ir --expires priima trukmę, pavyzdžiui, 30m, 24h ar 7d, arba ISO datą. Iki pradžios laiko nuoroda visai neatsidaro.
  • --max-openings pristabdo nuorodą po nurodyto atidarymų skaičiaus — naudinga vienkartiniams atsisiuntimams.

Nuorodą bet kada galite pristabdyti ir vėl įjungti su linkdash links update q4-deck --status paused ir --status active.

A/B testas trumpajai nuorodai

Linkdash kiekviena nuoroda yra vieno ar kelių variantų talpykla. Variantas — tai paskirtis (URL, failas ar tekstas) su savo svoriu ir taisyklėmis. Įprasta nuoroda turi vieną variantą, pavadintą main. Pridėkite daugiau, ir trumpoji nuoroda padalys srautą tarp jų:

linkdash links create --slug launch \
  --variant control --url https://example.com/pricing \
  --variant annual-first --url "https://example.com/pricing?view=annual"

Parametrai po kiekvieno --variant priklauso tam variantui iki kito --variant. Srautas dalijamas pagal svorį, kurio numatytoji reikšmė — 1, todėl aukščiau pateiktas pavyzdys yra 50/50 testas. Suteikite variantui --weight 3, kad jam tektų tris kartus daugiau srauto.

Pagal numatytuosius nustatymus priskyrimas pastovus: grįžęs lankytojas ir toliau gauna tą patį variantą — būtent to reikia sąžiningam testui. Pakeitę eksperimentą, paleiskite linkdash links update launch --restart-split — visi lankytojai bus vieną kartą perskirstyti iš naujo.

Linkdash nuoroda su dviem variantais, control ir annual-first, dalijanti srautą tarp dviejų kainų puslapių

Statistika pateikiama kiekvienam variantui atskirai, todėl juos galite tiesiogiai palyginti:

linkdash links stats launch --last 7d

Išvesties masyve variants kiekvienam variantui nurodomi visits, visitors, downloads ir plays. Daugiau apie statistiką — žemiau.

Lankytojų nukreipimas pagal šalį, įrenginį ar užklausos parametrą

Variantai taip pat gali turėti sąlygas. Pridėkite variantui --when, ir jį galės gauti tik atitinkantys lankytojai. Taip viena trumpoji nuoroda tampa maršrutizatoriumi. Pavyzdžiui, viena nuoroda, kuri telefonus nukreipia į tinkamą programėlių parduotuvę:

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

Kai lankytojas atidaro nuorodą, variantai, kurių sąlygos atitinka, sudaro atrankos rinkinį. Jei neatitinka nė vienas, naudojami variantai be sąlygų, todėl aukščiau esantis web pagauna visus, kurie nenaudoja iOS ar Android.

Linkdash nuoroda, nukreipianti lankytojus į App Store iOS įrenginiuose, į Google Play Android įrenginiuose ir į tinklalapį visus kitus

Galite tikrinti:

Raktas Ką tikrina Pavyzdys
country ISO šalių kodus --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 Kalbos žymas, pagal prefiksą --when language=de
referrer Nukreipiantį domeną --when referrer=twitter.com

Kartokite --when, kad reikalautumėte kelių sąlygų vienu metu. --when country=DE,AT --when device=mobile atitinka mobiliųjų įrenginių lankytojus iš Vokietijos ar Austrijos.

Variantai taip pat gali tikrinti lankytojo užklausos eilutę, todėl viena nuoroda gali elgtis skirtingai priklausomai nuo to, kur ją paskelbėte. lida.sh/launch?src=newsletter gali nusiųsti naujienlaiškio skaitytojus į specialų puslapį:

linkdash links variants add launch --name newsletter \
  --url https://example.com/pricing/newsletter \
  --when param:src=newsletter

Parametrų taisyklės palaiko „lygu“ (=), „nelygu“ (!=), „apima“ (~=), „prasideda“ (^=), „baigiasi“ ($=), „vienas iš“ (=a|b), „yra“ (param:ref?) ir „nėra“ (param:!ref). Jei norite, kad lankytojo parametrai būtų perduoti į paskirtį, kurkite nuorodą su --forward-params.

Valdymo skydelyje yra tie patys valdikliai, su šalių parinkikliu, kuriame ieškoma pagal pavadinimą, todėl nereikia prisiminti, kad Slovėnija yra SI:

Tikslinių šalių pasirinkimas variantui Linkdash valdymo skydelyje, pažymėtos Vokietija ir Austrija

Paspaudimų analitika terminale

linkdash links stats launch --last 7d

Išvestyje pateikiami bendri visits, downloads ir plays, apsilankymų skaičius jūsų nurodytu laikotarpiu (visitsInLast), šalys (countries) ir šaltiniai (referrers), iš kurių atėjo tie apsilankymai, suskirstymas pagal variantus (variants) ir sąrašas visitors su kiekvieno naujausio apsilankymo laiku, šalimi, įrenginiu, naršykle ir šaltiniu. --last priima trukmę, pavyzdžiui, 24h ar 30d, numatytoji — 24h.

Linkdash nesaugo lankytojų IP adresų. Adresas naudojamas lankytojo šaliai nustatyti ir anoniminiam lankytojo identifikatoriui, kuris keičiasi kasdien, sukurti, o tada pašalinamas.

Kad galėtumėte reaguoti į paspaudimus realiuoju laiku, užregistruokite webhook. Linkdash siunčia pasirašytus link.visit, link.download ir link.play įvykius į bet kurį HTTPS galinį tašką:

linkdash webhooks create --url https://example.com/hooks

Pasirašymo raktas parodomas vieną kartą, todėl iš karto jį išsaugokite. Kaip tikrinti parašus, aprašyta webhook dokumentacijoje.

Trumposios nuorodos DI agentams per MCP

Visa, kas aprašyta aukščiau, pasiekiama ir DI agentams. Linkdash veikia nuotolinis MCP serveris adresu https://api.linkdash.dev/mcp, o jo įrankiai atkartoja CLI: links_create, links_update, links_stats, variants_add, domains_add ir kiti, grąžinantys tą patį JSON.

Valdymo skydelio skiltyje API raktai sukurkite API raktą, tada prijunkite agentą. Claude Code:

claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
  --header "Authorization: Bearer $LINKDASH_API_KEY"

Cursor pridėkite jį į .cursor/mcp.json:

{
  "mcpServers": {
    "linkdash": {
      "url": "https://api.linkdash.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
    }
  }
}

Codex, kuris raktą skaito iš jūsų nurodyto aplinkos kintamojo:

codex mcp add linkdash --url https://api.linkdash.dev/mcp \
  --bearer-token-env-var LINKDASH_API_KEY

Nuo tada nuorodų galite prašyti paprasta kalba, pavyzdžiui, „sutrumpink https://example.com/pricing kaip pricing ir pažymėk žyma launch“ arba „kuris launch variantas šią savaitę sulaukė daugiau lankytojų?“, ir agentas iškvies tinkamą įrankį. MCP dokumentacijoje aprašytas ir OpenCode.

Jei jūsų agentas jau dirba terminale, jis gali naudoti CLI tiesiogiai. Įdiekite Linkdash agento skill, kad jis žinotų komandas ir parametrus:

npx skills add https://linkdash.dev/skills/linkdash/SKILL.md

HTTP API naudojimas

Jūsų kodui tos pačios operacijos pasiekiamos kaip paprasta REST API adresu https://api.linkdash.dev/v1, autentifikuojama tuo pačiu API raktu:

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" }'

Atsakymo struktūra tokia pati kaip CLI išvesties. API žinyne aprašyti visi galiniai taškai, įskaitant failų įkėlimą ir variantus.

Nuosavas domenas

Pagal numatytuosius nustatymus trumposios nuorodos veikia lida.sh domene. Norėdami jas pateikti savo domene, pridėkite jį ir nukreipkite DNS į Linkdash:

linkdash domains add go.example.com
linkdash domains verify go.example.com

Tada kurkite jame nuorodas su --domain go.example.com. Kiekvienas nuosavas domenas turi savo slug rinkinį, todėl go.example.com/launch nesikerta su kieno nors kito launch. Domenų vadove aprašytas DNS nustatymas, įskaitant nustatymą vienu spustelėjimu tiekėjams, kurie tai palaiko.

Kainos

Free planui nereikia kredito kortelės, jame yra 5 000 įvykių per mėnesį, 1 GB failų saugyklos, vieno mėnesio analitikos istorija ir vienas nuosavas domenas. Įvykis — tai apsilankymas, atsisiuntimas ar peržiūra vienoje iš jūsų nuorodų arba rašymo operacija, pavyzdžiui, nuorodos sukūrimas ar atnaujinimas. Skaitymo operacijos, pavyzdžiui, nuorodų sąrašo ar statistikos gavimas, nemokamos.

Mokami planai šiuos limitus padidina: Professional kainuoja 18 $ per mėnesį, Growth — 48 $ per mėnesį. Visas palyginimas — kainų puslapyje.

DUK

Ar yra nemokamas nuorodų trumpintuvas su CLI?

Taip. Linkdash CLI veikia su Free planu, kuriame yra 5 000 įvykių per mėnesį be kredito kortelės.

Ar galiu naudoti Linkdash CLI CI aplinkoje?

Taip. Nustatykite LINKDASH_TOKEN kaip sesijos žetoną, ir CLI veiks be naršyklės. Kadangi kiekviena komanda išveda JSON, nuorodas galite kurti ir atnaujinti iš GitHub Actions ar bet kurio kito konvejerio, o rezultatus skaityti su jq.

Ar DI agentai gali kurti trumpąsias nuorodas?

Taip, trimis būdais: per MCP serverį adresu https://api.linkdash.dev/mcp, per CLI su įdiegtu Linkdash agento skill arba per HTTP API. Visi trys suteikia tas pačias operacijas ir grąžina tą patį JSON.

Ar Linkdash saugo lankytojų IP adresus?

Ne. Linkdash naudoja adresą lankytojo šaliai nustatyti ir kasdien besikeičiančiam anoniminiam identifikatoriui sukurti, o tada jį pašalina. Nuorodų savininkai IP adresų niekada nemato.

Ar viena trumpoji nuoroda gali nukreipti skirtingus lankytojus į skirtingus puslapius?

Taip. Suteikite nuorodai kelis variantus ir kiekvienam pridėkite sąlygų, pavyzdžiui, šalį, įrenginį, operacinę sistemą, kalbą, šaltinį ar užklausos parametrą. Be sąlygų variantai dalija srautą pagal svorį — taip ir vykdomas A/B testas.


Norite išbandyti? Įdiekite CLI, paleiskite linkdash auth create ir sutrumpinkite pirmąją nuorodą greičiau nei per minutę. Greito starto vadove aprašyti visi žingsniai.