Liigu sisu juurde
Kõik postitused

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

Terminal, mis loob käsuga linkdash links create Linkdashi lühilingi

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.

Linkdashi töölaud, mis loetleb lühilinke koos tüübi, slugi, sihi ja olekuga

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:

  • --slug mää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.
  • --name on privaatne silt, mida näed ainult sina, mugav linkide hilisemaks leidmiseks.
  • --tag on korratav, nii et --tag launch --tag q4 lisab lingile kaks silti.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term ja --utm-content lisavad 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
  • --password küsib külastajatelt enne lingi avamist parooli.
  • --starts ja --expires võtavad vastu kestuse, näiteks 30m, 24h või 7d, või ISO kuupäeva. Enne algusaega link üldse ei avane.
  • --max-openings peatab 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.

Linkdashi link kahe variandiga, control ja annual-first, mis jaotab liikluse kahe hinnalehe vahel

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.

Linkdashi link, mis suunab külastajad iOS-is App Store’i, Androidis Google Playsse ja kõik teised veebilehele

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:

Variandi sihtriikide valimine Linkdashi töölaual, valitud on Saksamaa ja Austria

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.

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.