climcpapi
En CLI til at forkorte URL’er for udviklere og AI-agenter
Forkort URL’er fra kommandolinjen med Linkdash CLI. Del filer og tekststykker, kør A/B-tests, målret besøgende, og lad AI-agenter styre links via MCP.
Igor Kirnosov9 min. læsning

Linkdash er en linkforkorter, du styrer fra terminalen. Én kommando gør en URL, en fil eller et tekststykke til et kort link med tracking på lida.sh og udskriver resultatet som JSON, du kan sende videre til hvad som helst. De samme handlinger findes via et HTTP API og som en MCP-server, så en AI-agent kan oprette, opdatere og måle links med præcis de samme værktøjer, som du bruger.
Denne guide gennemgår hele CLI’en: installation, dit første korte link, deling af filer, låsning af links, A/B-tests, routing af besøgende efter land eller enhed og læsning af statistik uden at åbne en browser.

Installér Linkdash CLI
CLI’en er en npm-pakke og kræver Node.js 20 eller nyere.
npm i -g linkdash-cli
Det virker på samme måde med pnpm add -g linkdash-cli eller bun add -g linkdash-cli. Kommandoen, der installeres, hedder linkdash.
Opret derefter en konto, og log CLI’en ind i ét trin:
linkdash auth create
Det åbner tilmeldingssiden i din browser. Når du har en konto, godkender du koden, der vises i din terminal, og CLI’en er logget ind. Har du allerede en konto, så brug linkdash auth login i stedet. linkdash auth whoami bekræfter, hvilken konto du bruger, og CLI-referencen viser alle kommandoer og flag.
Sessionen gemmes i ~/.config/linkdash/config.json med rettigheder, så kun ejeren kan læse den. Til CI eller andre miljøer uden skærm sætter du LINKDASH_TOKEN til sessionstokenet fra den fil på en maskine, hvor du er logget ind, og behandler det som enhver anden hemmelighed.
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 brugerfladen: vellykkede kommandoer udskriver JSON på stdout, og fejl udskrives som almindelig tekst på stderr med exitkode 1. Der er intet --json-flag, fordi JSON er det eneste output. Det gør CLI’en nem at scripte. Sådan kopierer du et nyt kort link direkte til udklipsholderen på macOS:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Et par flag, du kommer til at bruge hele tiden:
--slugangiver den offentlige sti. Slugs bruger små bogstaver, tal og bindestreger inde i ordet, op til 64 tegn. Udelader du den, genererer Linkdash en.--nameer en privat etiket, som kun du ser, praktisk til at finde links senere.--tagkan gentages, så--tag launch --tag q4giver et link to tags.--utm-source,--utm-medium,--utm-campaign,--utm-termog--utm-contenttilføjer kampagneparametre til destinationen.
List og søg i det, du har oprettet, med linkdash links list --q pricing --tag launch.
Del en fil eller et tekststykke
Korte links er ikke kun til URL’er. Den samme kommando uploader en fil eller gemmer et tekststykke:
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
Et fillink giver de besøgende en download med forhåndsvisning af billeder og video. Et tekstlink viser tekststykket på en side med en kopiknap. Begge trackes som ethvert andet link, så du kan se, hvem der åbnede din præsentation og hvornår. Sådan erstatter du filen bag et eksisterende link uden at ændre URL’en:
linkdash links update board-deck --file ./board-deck-v2.pdf
Bestem, hvem der kan åbne et link
Hvert link kan have sine egne adgangsregler:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordbeder de besøgende om en adgangskode, før linket åbner.--startsog--expirestager en varighed som30m,24heller7deller en ISO-dato. Før starttidspunktet virker linket slet ikke.--max-openingssætter linket på pause efter det antal åbninger, hvilket er nyttigt til engangsdownloads.
Du kan til enhver tid sætte et link på pause og genoptage det med linkdash links update q4-deck --status paused og --status active.
Kør en A/B-test på et kort link
I Linkdash er hvert link en beholder for en eller flere varianter. En variant er en destination (en URL, en fil eller en tekst) med sin egen vægt og sine egne regler. Et almindeligt link har én variant med navnet main. Tilføj flere, og det korte link fordeler trafikken mellem dem:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Flag efter hvert --variant hører til den variant indtil den næste. Trafikken fordeles efter vægt, der som standard er 1, så eksemplet ovenfor er en 50/50-test. Giv en variant --weight 3 for at sende tre gange så meget trafik til den.
Tildelingen er fast som standard: en tilbagevendende besøgende får den samme variant igen, og det er det, du vil have for en fair test. Når du ændrer eksperimentet, blander linkdash links update launch --restart-split alle på ny én gang.

Statistikken kommer tilbage pr. variant, så du kan sammenligne dem direkte:
linkdash links stats launch --last 7d
variants-arrayet i outputtet viser visits, visitors, downloads og plays for hver variant. Mere om statistik nedenfor.
Send besøgende videre efter land, enhed eller query-parameter
Varianter kan også have betingelser. Tilføj --when til en variant, så kan kun besøgende, der matcher, få den. Det gør ét kort link til en router. For eksempel ét link, der sender telefoner til den rigtige app-butik:
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øgende åbner linket, udgør de varianter, hvis betingelser matcher, puljen. Matcher ingen, bruges varianterne uden betingelser i stedet, så web ovenfor fanger alle, der ikke er på iOS eller Android.

Du kan matche på:
| Nøgle | Matcher | Eksempel |
|---|---|---|
country |
ISO-landekoder | --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 |
Sprogtags, efter præfiks | --when language=de |
referrer |
Den henvisende host | --when referrer=twitter.com |
Gentag --when for at kræve flere betingelser på én gang. --when country=DE,AT --when device=mobile matcher mobilbesøgende fra Tyskland eller Østrig.
Varianter kan også matche den besøgendes querystreng, så ét link kan opføre sig forskelligt afhængigt af, hvor du har delt det. lida.sh/launch?src=newsletter kan sende læsere af nyhedsbrevet et særligt sted hen:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Parameterregler understøtter er lig med (=), er ikke (!=), indeholder (~=), starter med (^=), slutter med ($=), en af (=a|b), findes (param:ref?) og mangler (param:!ref). Vil du i stedet sende den besøgendes parametre videre til destinationen, så opret linket med --forward-params.
Dashboardet har de samme muligheder med en landevælger, der søger på navn, så du ikke behøver at huske, at Slovenien er SI:

Læs klikstatistik i terminalen
linkdash links stats launch --last 7d
Outputtet indeholder det samlede antal visits, downloads og plays, antallet af besøg i det tidsrum, du bad om (visitsInLast), de countries og referrers, besøgene kom fra, en opdeling på variants og en visitors-liste med tidspunkt, land, enhed, browser og referrer for hvert af de seneste besøg. --last tager en varighed som 24h eller 30d og er som standard 24h.
Linkdash gemmer ikke de besøgendes IP-adresser. Adressen bruges til at slå den besøgendes land op og til at udlede et anonymt besøgs-id, der skifter dagligt, og derefter kasseres den.
Vil du reagere på klik, i takt med at de sker, så registrér en webhook. Linkdash sender signerede link.visit-, link.download- og link.play-hændelser til ethvert HTTPS-endpoint:
linkdash webhooks create --url https://example.com/hooks
Signeringshemmeligheden udskrives kun én gang, så gem den med det samme. Se dokumentationen om webhooks for at bekræfte signaturer.
Lad AI-agenter oprette korte links med MCP
Alt ovenfor er også tilgængeligt for AI-agenter. Linkdash kører en remote MCP-server på https://api.linkdash.dev/mcp, og dens værktøjer spejler CLI’en: links_create, links_update, links_stats, variants_add, domains_add og resten, der returnerer den samme JSON.
Opret en API-nøgle i dashboardet under API-nøgler, og forbind så din agent. I Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
I Cursor tilføjer du den til .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
I Codex, der læser nøglen fra den miljøvariabel, du angiver:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Derefter kan du bede om links med almindelige ord, f.eks. »forkort https://example.com/pricing som pricing, og tag det med launch« eller »hvilken variant af launch fik flest besøgende i denne uge?«, og agenten kalder det rigtige værktøj. Dokumentationen om MCP dækker også OpenCode.
Arbejder din agent allerede i en terminal, kan den bruge CLI’en direkte. Installér Linkdash-skill’en til agenter, så den kender kommandoerne og flagene:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Brug HTTP API’et
I din egen kode er de samme handlinger et almindeligt REST API på https://api.linkdash.dev/v1, godkendt med den samme API-nøgle:
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 CLI’ens output. API-referencen dækker alle endpoints, inklusive filuploads og varianter.
Brug dit eget domæne
Korte links ligger som standard på lida.sh. Vil du servere dem fra dit eget domæne i stedet, så tilføj det, og peg din DNS på Linkdash:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Opret derefter links på det med --domain go.example.com. Hvert eget domæne har sine egne slugs, så go.example.com/launch ikke kolliderer med andres launch. Guiden til domæner dækker DNS-opsætningen, inklusive opsætning med ét klik hos udbydere, der understøtter det.
Priser
Free-planen kræver intet kreditkort og indeholder 5.000 hændelser om måneden, 1 GB fillager, én måneds statistikhistorik og ét eget domæne. En hændelse er et besøg, en download eller en afspilning på et af dine links eller en skrivning som at oprette eller opdatere et link. Læsninger som at liste links eller hente statistik er gratis.
Betalte planer hæver grænserne: Professional koster 18 $ om måneden, og Growth koster 48 $ om måneden. Se priser for den fulde sammenligning.
FAQ
Findes der en gratis linkforkorter med CLI?
Ja. Linkdash CLI virker på Free-planen, som indeholder 5.000 hændelser om måneden uden kreditkort.
Kan jeg bruge Linkdash CLI i CI?
Ja. Sæt LINKDASH_TOKEN til et sessionstoken, så kører CLI’en uden browser. Fordi hver kommando udskriver JSON, kan du oprette og opdatere links fra GitHub Actions eller enhver anden pipeline og læse resultaterne med jq.
Kan AI-agenter oprette korte links?
Ja, på tre måder: via MCP-serveren på https://api.linkdash.dev/mcp, via CLI’en med Linkdash-skill’en til agenter installeret eller via HTTP API’et. Alle tre giver adgang til de samme handlinger og returnerer den samme JSON.
Gemmer Linkdash de besøgendes IP-adresser?
Nej. Linkdash bruger adressen til at slå den besøgendes land op og til at lave et dagligt anonymt id og kasserer den derefter. Linkejere ser aldrig IP-adresser.
Kan ét kort link sende forskellige besøgende til forskellige sider?
Ja. Giv et link flere varianter, og tilføj betingelser som land, enhed, styresystem, sprog, referrer eller query-parameter til hver. Uden betingelser fordeler varianter trafikken efter vægt, og det er sådan, du kører en A/B-test.
Klar til at prøve det? Installér CLI’en, kør linkdash auth create, og forkort dit første link på under et minut. Kom hurtigt i gang har alle trinene.

