climcpapi
URL-i lühendaja CLI arendajatele ja AI-agentidele
Lühenda URL-e käsurealt Linkdashi CLI-ga. Jaga faile ja tekstilõike, tee A/B-teste, sihi külastajaid ja lase AI-agentidel linke MCP kaudu hallata.
Igor Kirnosov8 min lugemist

Linkdash on URL-i lühendaja, mida juhid terminalist. Üks käsk muudab URL-i, faili või tekstilõigu jälgitavaks lühilingiks domeenil lida.sh ja väljastab tulemuse JSON-ina, mille saad suunata ükskõik kuhu. Samad toimingud on saadaval HTTP API kaudu ja MCP-serverina, nii et AI-agent saab linke luua, uuendada ja mõõta täpselt samade tööriistadega, mida kasutad sina.
See juhend käib läbi kogu CLI: paigaldamise, esimese lingi lühendamise, failide jagamise, linkide lukustamise, A/B-testid, külastajate suunamise riigi või seadme järgi ja analüütika lugemise brauserit avamata.

Paigalda Linkdashi CLI
CLI on npm-pakett ja vajab Node.js 20 või uuemat.
npm i -g linkdash-cli
Sama hästi töötavad pnpm add -g linkdash-cli või bun add -g linkdash-cli. Paigaldatav käsk on linkdash.
Seejärel loo konto ja logi CLI-ga sisse ühe sammuga:
linkdash auth create
See avab brauseris registreerumislehe. Kui konto on olemas, kinnitad terminalis kuvatud koodi ja CLI on sisse logitud. Kui sul on konto juba olemas, kasuta selle asemel linkdash auth login. linkdash auth whoami näitab, millist kontot kasutad, ja CLI viide loetleb kõik käsud ja lipud.
Seanss salvestatakse faili ~/.config/linkdash/config.json ainult omanikule lubatud õigustega. CI või muude graafilise liideseta keskkondade jaoks määra LINKDASH_TOKEN väärtuseks seansitoken sellest failist masinas, kus oled sisse loginud, ja käsitle seda nagu iga teist saladust.
Lühenda URL käsurealt
linkdash links create --url https://example.com/pricing --slug pricing
{
"id": "pricing",
"url": "https://lida.sh/pricing",
"kind": "url",
"variants": [
{ "name": "main", "kind": "url" }
]
}
See ongi kogu liides: edukad käsud väljastavad JSON-i stdout’i ja vead lihtteksti stderr’i väljumiskoodiga 1. Lippu --json pole, sest JSON on ainus väljund. Seetõttu on CLI-d lihtne skriptida. Värske lühilingi kopeerimiseks otse macOS-i lõikelauale:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Mõned lipud, mida kasutad pidevalt:
--slugmäärab avaliku tee. Slugides on väiketähed, numbrid ja sisemised sidekriipsud, kuni 64 tähemärki. Kui selle ära jätad, genereerib Linkdash selle ise.--nameon privaatne silt, mida näed ainult sina, mugav linkide hilisemaks leidmiseks.--tagon korratav, nii et--tag launch --tag q4lisab lingile kaks silti.--utm-source,--utm-medium,--utm-campaign,--utm-termja--utm-contentlisavad sihtkohale kampaaniaparameetrid.
Loodud linke saad loetleda ja otsida käsuga linkdash links list --q pricing --tag launch.
Jaga faili või tekstilõiku
Lühilingid pole ainult URL-ide jaoks. Sama käsk laadib üles faili või salvestab tekstilõigu:
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
Failiga link annab külastajatele allalaadimise, piltide ja videote puhul koos eelvaatega. Tekstiga link näitab tekstilõiku lehel koos kopeerimisnupuga. Mõlemat jälgitakse nagu iga teist linki, nii et näed, kes sinu esitluse avas ja millal. Olemasoleva lingi taga oleva faili asendamiseks URL-i muutmata:
linkdash links update board-deck --file ./board-deck-v2.pdf
Kontrolli, kes saab lingi avada
Igal lingil võivad olla oma juurdepääsureeglid:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordküsib külastajatelt enne lingi avamist parooli.--startsja--expiresvõtavad vastu kestuse, näiteks30m,24hvõi7d, või ISO kuupäeva. Enne algusaega link üldse ei avane.--max-openingspeatab lingi pärast nii mitut avamist, mis on kasulik ühekordsete allalaadimiste jaoks.
Lingi saad igal ajal peatada ja jätkata käskudega linkdash links update q4-deck --status paused ja --status active.
Tee lühilingiga A/B-test
Linkdashis on iga link ühe või mitme variandi konteiner. Variant on sihtkoht (URL, fail või tekst) oma kaalu ja reeglitega. Tavalisel lingil on üks variant nimega main. Lisa veel ja lühilink jaotab liikluse nende vahel:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Iga --variant järel olevad lipud kuuluvad sellele variandile kuni järgmiseni. Liiklus jaotatakse kaalu järgi, mille vaikeväärtus on 1, nii et ülaltoodud näide on 50/50 test. Anna variandile --weight 3, et saata sellele kolm korda rohkem liiklust.
Määramine on vaikimisi püsiv: naasev külastaja saab ikka sama variandi, mida ausaks testiks vajadki. Kui muudad eksperimenti, segab linkdash links update launch --restart-split kõik ühe korra uuesti.

Statistika tuleb variantide kaupa, nii et saad neid otse võrrelda:
linkdash links stats launch --last 7d
Väljundi massiiv variants näitab iga variandi kohta visits, visitors, downloads ja plays. Statistikast lähemalt allpool.
Suuna külastajaid riigi, seadme või päringuparameetri järgi
Variantidel võivad olla ka tingimused. Lisa variandile --when ja selle saavad ainult sobivad külastajad. Nii muutub üks lühilink ruuteriks. Näiteks üks link, mis saadab telefonid õigesse rakenduspoodi:
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
Kui külastaja lingi avab, moodustavad valiku variandid, mille tingimused sobivad. Kui ükski ei sobi, kasutatakse tingimusteta variante, nii et ülaltoodud web püüab kinni kõik, kes pole iOS-is ega Androidis.

Sobitada saad järgmiste järgi:
| Võti | Sobitab | Näide |
|---|---|---|
country |
ISO riigikoodid | --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 |
Keelesildid, prefiksi järgi | --when language=de |
referrer |
Viitav host | --when referrer=twitter.com |
Korda --when, et nõuda mitut tingimust korraga. --when country=DE,AT --when device=mobile sobib mobiilikülastajatele Saksamaalt või Austriast.
Variandid saavad sobitada ka külastaja päringustringi, nii et üks link võib käituda erinevalt sõltuvalt sellest, kus sa seda jagasid. lida.sh/launch?src=newsletter saab saata uudiskirja lugejad kuhugi eriti:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Parameetrireeglid toetavad võrdub (=), ei võrdu (!=), sisaldab (~=), algab (^=), lõpeb ($=), üks järgmistest (=a|b), olemas (param:ref?) ja puudub (param:!ref). Kui tahad hoopis külastaja parameetrid sihtkohta edasi anda, loo link lipuga --forward-params.
Töölaual on samad juhtelemendid ning riigivalija, mis otsib nime järgi, nii et sa ei pea meeles pidama, et Sloveenia on SI:

Loe klikianalüütikat terminalist
linkdash links stats launch --last 7d
Väljund sisaldab visits, downloads ja plays kogusummasid, küsitud ajaakna külastuste arvu (visitsInLast), riike (countries) ja viitajaid (referrers), kust need külastused tulid, variants jaotust ning loendit visitors iga hiljutise külastuse aja, riigi, seadme, brauseri ja viitajaga. --last võtab vastu kestuse, näiteks 24h või 30d, ja vaikimisi on see 24h.
Linkdash ei salvesta külastajate IP-aadresse. Aadressi kasutatakse külastaja riigi tuvastamiseks ja anonüümse, iga päev muutuva külastaja identifikaatori tuletamiseks, seejärel see visatakse ära.
Klikkidele reaalajas reageerimiseks registreeri webhook. Linkdash saadab allkirjastatud sündmused link.visit, link.download ja link.play igale HTTPS-otspunktile:
linkdash webhooks create --url https://example.com/hooks
Allkirjastamise saladus kuvatakse üks kord, nii et salvesta see kohe. Allkirjade kontrollimise kohta vaata webhookide dokumentatsiooni.
Lase AI-agentidel MCP kaudu lühilinke luua
Kõik ülaltoodu on saadaval ka AI-agentidele. Linkdash käitab kaug-MCP-serverit aadressil https://api.linkdash.dev/mcp ja selle tööriistad peegeldavad CLI-d: links_create, links_update, links_stats, variants_add, domains_add ja ülejäänud, mis tagastavad sama JSON-i.
Loo töölaual jaotises API-võtmed API-võti ja ühenda oma agent. Claude Code’is:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
Cursoris lisa see faili .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
Codexis, mis loeb võtme sinu nimetatud keskkonnamuutujast:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Edaspidi saad linke küsida tavakeeles, näiteks „lühenda https://example.com/pricing kui pricing ja lisa silt launch“ või „milline launch’i variant sai sel nädalal rohkem külastajaid?“, ja agent kutsub õiget tööriista. MCP dokumentatsioon käsitleb ka OpenCode’i.
Kui sinu agent juba töötab terminalis, saab see CLI-d otse kasutada. Paigalda Linkdashi agendi skill, et see teaks käske ja lippe:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Kasuta HTTP API-t
Sinu enda koodi jaoks on samad toimingud lihtne REST API aadressil https://api.linkdash.dev/v1, autentimine sama API-võtmega:
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" }'
Vastusel on sama kuju nagu CLI väljundil. API viide käsitleb kõiki otspunkte, sealhulgas failide üleslaadimist ja variante.
Kasuta oma domeeni
Lühilingid asuvad vaikimisi domeenil lida.sh. Kui tahad neid hoopis oma domeenilt näidata, lisa see ja suuna oma DNS Linkdashile:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Seejärel loo sellel linke lipuga --domain go.example.com. Igal oma domeenil on oma slugid, nii et go.example.com/launch ei põrka kokku kellegi teise launch’iga. Domeenide juhend käsitleb DNS-i seadistamist, sealhulgas ühe klõpsuga seadistust seda toetavate teenusepakkujate puhul.
Hinnad
Free pakett ei vaja krediitkaarti ja sisaldab 5000 sündmust kuus, 1 GB failide salvestusruumi, ühe kuu analüütika ajalugu ja ühte oma domeeni. Sündmus on külastus, allalaadimine või esitus mõnel sinu lingil või kirjutamine, näiteks lingi loomine või uuendamine. Lugemised, näiteks linkide loetlemine või statistika pärimine, on tasuta.
Tasulised paketid tõstavad neid limiite: Professional maksab 18 $ kuus ja Growth 48 $ kuus. Täieliku võrdluse leiad hindade lehelt.
KKK
Kas on olemas tasuta URL-i lühendaja koos CLI-ga?
Jah. Linkdashi CLI töötab Free paketis, mis sisaldab 5000 sündmust kuus ilma krediitkaardita.
Kas saan Linkdashi CLI-d kasutada CI-s?
Jah. Määra LINKDASH_TOKEN väärtuseks seansitoken ja CLI töötab ilma brauserita. Kuna iga käsk väljastab JSON-i, saad linke luua ja uuendada GitHub Actionsist või mõnest muust torust ning tulemusi lugeda jq-ga.
Kas AI-agendid saavad lühilinke luua?
Jah, kolmel viisil: MCP-serveri kaudu aadressil https://api.linkdash.dev/mcp, CLI kaudu koos paigaldatud Linkdashi agendi skilliga või HTTP API kaudu. Kõik kolm pakuvad samu toiminguid ja tagastavad sama JSON-i.
Kas Linkdash salvestab külastajate IP-aadresse?
Ei. Linkdash kasutab aadressi külastaja riigi tuvastamiseks ja igapäevase anonüümse identifikaatori loomiseks ning viskab selle seejärel ära. Lingiomanikud ei näe kunagi IP-aadresse.
Kas üks lühilink saab saata eri külastajad eri lehtedele?
Jah. Anna lingile mitu varianti ja lisa igaühele tingimused, näiteks riik, seade, operatsioonisüsteem, keel, viitaja või päringuparameeter. Ilma tingimusteta jaotavad variandid liiklust kaalu järgi — nii teedki A/B-testi.
Valmis proovima? Paigalda CLI, käivita linkdash auth create ja lühenda oma esimene link vähem kui minutiga. Kiirstardis on kõik sammud.

