Gå til innholdet
Alle innlegg

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

En terminal som lager en kortlenke i Linkdash med kommandoen linkdash links create

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.

Linkdash-dashbordet med en liste over kortlenker med type, slug, mål og status

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:

  • --slug angir den offentlige stien. Slugs bruker små bokstaver, sifre og bindestreker inni, opptil 64 tegn. Utelater du den, genererer Linkdash en.
  • --name er en privat etikett som bare du ser, praktisk for å finne lenker senere.
  • --tag kan gjentas, så --tag launch --tag q4 gir en lenke to tagger.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term og --utm-content legger 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
  • --password ber besøkende om et passord før lenken åpnes.
  • --starts og --expires tar en varighet som 30m, 24h eller 7d, eller en ISO-dato. Før starttidspunktet fungerer ikke lenken i det hele tatt.
  • --max-openings setter 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.

En Linkdash-lenke med to varianter, control og annual-first, som fordeler trafikk mellom to prissider

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.

En Linkdash-lenke som sender besøkende til App Store på iOS, Google Play på Android og en nettside for alle andre

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:

Valg av målland for en variant i Linkdash-dashbordet, med Tyskland og Østerrike valgt

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.