Gå til indhold
Alle indlæg

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

En terminal, der opretter et kort Linkdash-link med kommandoen linkdash links create

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.

Linkdash-dashboardet med en liste over korte links med type, slug, destination og status

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:

  • --slug angiver den offentlige sti. Slugs bruger små bogstaver, tal og bindestreger inde i ordet, op til 64 tegn. Udelader du den, genererer Linkdash en.
  • --name er en privat etiket, som kun du ser, praktisk til at finde links senere.
  • --tag kan gentages, så --tag launch --tag q4 giver et link to tags.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term og --utm-content tilfø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

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
  • --password beder de besøgende om en adgangskode, før linket åbner.
  • --starts og --expires tager en varighed som 30m, 24h eller 7d eller en ISO-dato. Før starttidspunktet virker linket slet ikke.
  • --max-openings sæ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.

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.

Et Linkdash-link med to varianter, control og annual-first, der fordeler trafikken mellem to prissider

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.

Et Linkdash-link, der sender besøgende til App Store på iOS, Google Play på Android og en webside for alle andre

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:

Valg af lande til en variant i Linkdash-dashboardet med Tyskland og Østrig valgt

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.

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.

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.

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.

Linkdash

© 2026 Igor Kirnosov s.p. Alle rettigheder forbeholdes.