climcpapi
En lenkeforkorter med CLI for utviklere og KI-agenter
Forkort URL-er fra kommandolinjen med Linkdash CLI. Del filer og tekstutdrag, kjør A/B-tester, målrett besøkende og la KI-agenter styre lenker via MCP.
Igor Kirnosov9 min lesetid

Linkdash er en lenkeforkorter du styrer fra terminalen. Én kommando gjør en URL, en fil eller et tekstutdrag om til en sporet kortlenke på lida.sh og skriver ut resultatet som JSON du kan sende videre til hva som helst. De samme operasjonene er tilgjengelige via et HTTP API og som en MCP-server, så en KI-agent kan opprette, oppdatere og måle lenker med nøyaktig de samme verktøyene som du bruker.
Denne veiledningen går gjennom hele CLI-et: installasjon, din første kortlenke, deling av filer, låsing av lenker, A/B-tester, ruting av besøkende etter land eller enhet og lesing av analyse uten å åpne en nettleser.

Installer Linkdash CLI
CLI-et er en npm-pakke og krever Node.js 20 eller nyere.
npm i -g linkdash-cli
Det fungerer på samme måte med pnpm add -g linkdash-cli eller bun add -g linkdash-cli. Kommandoen som installeres, heter linkdash.
Opprett deretter en konto og logg inn CLI-et, i ett steg:
linkdash auth create
Dette åpner registreringssiden i nettleseren. Når du har en konto, godkjenner du koden som vises i terminalen, og CLI-et er logget inn. Har du allerede en konto, bruker du linkdash auth login i stedet. linkdash auth whoami bekrefter hvilken konto du bruker, og CLI-referansen viser alle kommandoer og flagg.
Økten lagres i ~/.config/linkdash/config.json med tillatelser bare for eieren. For CI eller andre miljøer uten grensesnitt setter du LINKDASH_TOKEN til økttokenet fra den filen på en maskin der du har logget inn, og behandler det som enhver annen hemmelighet.
Forkort en URL fra kommandolinjen
linkdash links create --url https://example.com/pricing --slug pricing
{
"id": "pricing",
"url": "https://lida.sh/pricing",
"kind": "url",
"variants": [
{ "name": "main", "kind": "url" }
]
}
Det er hele grensesnittet: vellykkede kommandoer skriver JSON til stdout, og feil skrives som ren tekst til stderr med avslutningskode 1. Det finnes ikke noe --json-flagg, fordi JSON er det eneste formatet. Det gjør CLI-et enkelt å skripte. Slik kopierer du en ny kortlenke rett til utklippstavlen på macOS:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Noen flagg du kommer til å bruke hele tiden:
--slugangir den offentlige stien. Slugs bruker små bokstaver, sifre og bindestreker inni, opptil 64 tegn. Utelater du den, genererer Linkdash en.--nameer en privat etikett som bare du ser, praktisk for å finne lenker senere.--tagkan gjentas, så--tag launch --tag q4gir en lenke to tagger.--utm-source,--utm-medium,--utm-campaign,--utm-termog--utm-contentlegger til kampanjeparametere i målet.
List opp og søk i det du har laget, med linkdash links list --q pricing --tag launch.
Del en fil eller et tekstutdrag
Kortlenker er ikke bare for URL-er. Den samme kommandoen laster opp en fil eller lagrer et tekstutdrag:
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
En fillenke gir besøkende en nedlasting, med forhåndsvisning for bilder og video. En tekstlenke viser utdraget på en side med en kopieringsknapp. Begge spores som alle andre lenker, så du kan se hvem som åpnet presentasjonen din, og når. Slik erstatter du filen bak en eksisterende lenke uten å endre URL-en:
linkdash links update board-deck --file ./board-deck-v2.pdf
Bestem hvem som kan åpne en lenke
Hver lenke kan ha sine egne tilgangsregler:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordber besøkende om et passord før lenken åpnes.--startsog--expirestar en varighet som30m,24heller7d, eller en ISO-dato. Før starttidspunktet fungerer ikke lenken i det hele tatt.--max-openingssetter lenken på pause etter så mange åpninger, noe som er nyttig for engangsnedlastinger.
Du kan sette en lenke på pause og gjenoppta den når som helst med linkdash links update q4-deck --status paused og --status active.
Kjør en A/B-test på en kortlenke
I Linkdash er hver lenke en beholder for én eller flere varianter. En variant er et mål (en URL, en fil eller tekst) med sin egen vekt og sine egne regler. En vanlig lenke har én variant som heter main. Legg til flere, så fordeler kortlenken trafikken mellom dem:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Flagg etter hver --variant hører til den varianten frem til den neste. Trafikken fordeles etter vekt, som er 1 som standard, så eksemplet over er en 50/50-test. Gi en variant --weight 3 for å sende tre ganger så mye trafikk til den.
Tildelingen er fast som standard: en tilbakevendende besøkende får den samme varianten igjen, og det er det du vil ha for en rettferdig test. Når du endrer eksperimentet, stokker linkdash links update launch --restart-split om alle én gang.

Statistikken kommer per variant, så du kan sammenligne dem direkte:
linkdash links stats launch --last 7d
variants-listen i utdataene viser visits, visitors, downloads og plays for hver variant. Mer om statistikk nedenfor.
Rut besøkende etter land, enhet eller spørreparameter
Varianter kan også ha betingelser. Legg til --when på en variant, så kan bare besøkende som matcher, få den. Dette gjør én kortlenke om til en ruter. For eksempel én lenke som sender telefoner til riktig appbutikk:
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
Når en besøkende åpner lenken, utgjør variantene med betingelser som matcher, utvalget. Hvis ingen matcher, brukes variantene uten betingelser i stedet, så web over fanger opp alle som ikke bruker iOS eller Android.

Du kan matche på:
| Nøkkel | Matcher | Eksempel |
|---|---|---|
country |
ISO-landskoder | --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 |
Språktagger, etter prefiks | --when language=de |
referrer |
Den henvisende verten | --when referrer=twitter.com |
Gjenta --when for å kreve flere betingelser samtidig. --when country=DE,AT --when device=mobile matcher mobilbesøkende fra Tyskland eller Østerrike.
Varianter kan også matche den besøkendes spørrestreng, så én lenke kan oppføre seg ulikt avhengig av hvor du delte den. lida.sh/launch?src=newsletter kan sende lesere av nyhetsbrevet til et eget sted:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Parameterregler støtter er lik (=), er ikke lik (!=), inneholder (~=), starter med (^=), slutter med ($=), en av (=a|b), finnes (param:ref?) og mangler (param:!ref). Vil du heller at den besøkendes parametere sendes videre til målet, oppretter du lenken med --forward-params.
Dashbordet har de samme kontrollene, med en landvelger som søker etter navn, så du slipper å huske at Slovenia er SI:

Les klikkanalyse fra terminalen
linkdash links stats launch --last 7d
Utdataene inneholder totalt antall visits, downloads og plays, antall besøk i tidsvinduet du ba om (visitsInLast), hvilke countries og referrers besøkene kom fra, en oversikt over variants, og en visitors-liste med tidspunkt, land, enhet, nettleser og henviser for hvert nylig besøk. --last tar en varighet som 24h eller 30d og er 24h som standard.
Linkdash lagrer ikke IP-adressene til besøkende. Adressen brukes til å slå opp den besøkendes land og til å utlede en anonym besøksidentifikator som endres daglig, og deretter forkastes den.
For å reagere på klikk mens de skjer, registrerer du en webhook. Linkdash sender signerte link.visit-, link.download- og link.play-hendelser til et hvilket som helst HTTPS-endepunkt:
linkdash webhooks create --url https://example.com/hooks
Signeringshemmeligheten skrives ut bare én gang, så lagre den med en gang. Se dokumentasjonen om webhooks for hvordan du verifiserer signaturer.
La KI-agenter lage kortlenker med MCP
Alt over er også tilgjengelig for KI-agenter. Linkdash kjører en ekstern MCP-server på https://api.linkdash.dev/mcp, og verktøyene speiler CLI-et: links_create, links_update, links_stats, variants_add, domains_add og resten, med samme JSON i retur.
Opprett en API-nøkkel i dashbordet under API-nøkler, og koble til agenten din. I Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
I Cursor legger du den til i .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
I Codex, som leser nøkkelen fra miljøvariabelen du angir:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Fra da av kan du be om lenker med vanlig språk, for eksempel «forkort https://example.com/pricing som pricing og tagg den med launch» eller «hvilken variant av launch fikk flest besøkende denne uken?», og agenten kaller riktig verktøy. MCP-dokumentasjonen dekker også OpenCode.
Jobber agenten din allerede i en terminal, kan den bruke CLI-et direkte. Installer Linkdash sin agent-skill, så kjenner den kommandoene og flaggene:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Bruk HTTP API-et
For din egen kode er de samme operasjonene et vanlig REST API på https://api.linkdash.dev/v1, autentisert med den samme API-nøkkelen:
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" }'
Svaret har samme form som utdataene fra CLI-et. API-referansen dekker alle endepunkter, inkludert filopplastinger og varianter.
Bruk ditt eget domene
Kortlenker ligger på lida.sh som standard. For å servere dem fra ditt eget domene i stedet legger du det til og peker DNS-en din mot Linkdash:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Deretter oppretter du lenker på det med --domain go.example.com. Hvert eget domene har sitt eget sett med slugs, så go.example.com/launch kolliderer ikke med noen andres launch. Veiledningen om domener dekker DNS-oppsett, inkludert oppsett med ett klikk for leverandører som støtter det.
Priser
Free-planen krever ikke kredittkort og inkluderer 5 000 hendelser i måneden, 1 GB fillagring, én måned med analysehistorikk og ett eget domene. En hendelse er et besøk, en nedlasting eller en avspilling på en av lenkene dine, eller en skriveoperasjon som å opprette eller oppdatere en lenke. Lesing, som å liste opp lenker eller hente statistikk, er gratis.
Betalte planer hever disse grensene: Professional koster $18 i måneden og Growth $48 i måneden. Se priser for den fullstendige sammenligningen.
Vanlige spørsmål
Finnes det en gratis lenkeforkorter med CLI?
Ja. Linkdash CLI fungerer med Free-planen, som inkluderer 5 000 hendelser i måneden uten kredittkort.
Kan jeg bruke Linkdash CLI i CI?
Ja. Sett LINKDASH_TOKEN til et økttoken, så kjører CLI-et uten nettleser. Fordi hver kommando skriver ut JSON, kan du opprette og oppdatere lenker fra GitHub Actions eller en hvilken som helst annen pipeline og lese resultatene med jq.
Kan KI-agenter lage kortlenker?
Ja, på tre måter: via MCP-serveren på https://api.linkdash.dev/mcp, via CLI-et med Linkdash sin agent-skill installert, eller via HTTP API-et. Alle tre gir tilgang til de samme operasjonene og returnerer samme JSON.
Lagrer Linkdash IP-adressene til besøkende?
Nei. Linkdash bruker adressen til å slå opp den besøkendes land og til å lage en daglig anonym identifikator, og forkaster den deretter. Lenkeeiere ser aldri IP-adresser.
Kan én kortlenke sende ulike besøkende til ulike sider?
Ja. Gi en lenke flere varianter, og legg til betingelser som land, enhet, operativsystem, språk, henviser eller spørreparameter på hver av dem. Uten betingelser fordeler variantene trafikken etter vekt, og det er slik du kjører en A/B-test.
Klar til å prøve? Installer CLI-et, kjør linkdash auth create, og forkort din første lenke på under ett minutt. Hurtigstarten har alle stegene.

