Hoppa till innehållet
Alla inlägg

climcpapi

En länkförkortare med CLI för utvecklare och AI-agenter

Korta URL:er från kommandoraden med Linkdash CLI. Dela filer och textsnuttar, kör A/B-tester, rikta dig till besökare och låt AI-agenter hantera länkar via MCP.

Igor Kirnosov9 min läsning

Terminal som skapar en Linkdash-kortlänk med kommandot linkdash links create

Linkdash är en länkförkortare som du styr från terminalen. Ett kommando gör om en URL, en fil eller en textsnutt till en spårad kortlänk på lida.sh och skriver ut resultatet som JSON som du kan skicka vidare till vad som helst. Samma operationer finns i ett HTTP API och som en MCP-server, så en AI-agent kan skapa, uppdatera och mäta länkar med exakt samma verktyg som du använder.

Den här guiden går igenom hela CLI:t: installation, din första kortlänk, att dela filer, att låsa länkar, A/B-tester, att dirigera besökare efter land eller enhet och att läsa statistik utan att öppna en webbläsare.

Linkdash-dashboarden med en lista över kortlänkar med typ, slug, mål och status

Installera Linkdash CLI

CLI:t är ett npm-paket och kräver Node.js 20 eller senare.

npm i -g linkdash-cli

Det fungerar likadant med pnpm add -g linkdash-cli eller bun add -g linkdash-cli. Kommandot som installeras heter linkdash.

Skapa sedan ett konto och logga in CLI:t i ett enda steg:

linkdash auth create

Det öppnar registreringssidan i webbläsaren. När du har ett konto godkänner du koden som visas i terminalen, och CLI:t är inloggat. Har du redan ett konto använder du linkdash auth login i stället. linkdash auth whoami bekräftar vilket konto du använder, och CLI-referensen listar alla kommandon och flaggor.

Sessionen sparas i ~/.config/linkdash/config.json med behörigheter som bara ägaren har. För CI eller andra miljöer utan gränssnitt sätter du LINKDASH_TOKEN till sessionstoken från den filen på en dator där du har loggat in, och behandlar den som vilken annan hemlighet som helst.

Korta en URL från kommandoraden

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 är hela gränssnittet: lyckade kommandon skriver ut JSON på stdout, och fel skrivs ut som vanlig text på stderr med slutkod 1. Det finns ingen --json-flagga eftersom JSON är det enda utdataformatet. Det gör CLI:t enkelt att skripta. Så här kopierar du en ny kortlänk direkt till urklipp på macOS:

linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy

Några flaggor du kommer att använda hela tiden:

  • --slug anger den publika sökvägen. Slugs består av små bokstäver, siffror och bindestreck inuti, upp till 64 tecken. Utelämnar du den genererar Linkdash en.
  • --name är en privat etikett som bara du ser, praktisk när du ska hitta länkar senare.
  • --tag kan upprepas, så --tag launch --tag q4 ger en länk två taggar.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term och --utm-content lägger till kampanjparametrar på målet.

Lista och sök bland det du har skapat med linkdash links list --q pricing --tag launch.

Dela en fil eller en textsnutt

Kortlänkar är inte bara till för URL:er. Samma kommando laddar upp en fil eller sparar en textsnutt:

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 fillänk ger besökarna en nedladdning, med förhandsvisning för bilder och video. En textlänk visar textsnutten på en sida med en kopieringsknapp. Båda spåras som alla andra länkar, så du kan se vem som öppnade din presentation och när. Så här byter du filen bakom en befintlig länk utan att ändra URL:en:

linkdash links update board-deck --file ./board-deck-v2.pdf

Bestäm vem som kan öppna en länk

Varje länk kan ha egna åtkomstregler:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • --password ber besökarna om ett lösenord innan länken öppnas.
  • --starts och --expires tar en tidsperiod som 30m, 24h eller 7d, eller ett ISO-datum. Före starttiden fungerar länken inte alls.
  • --max-openings pausar länken efter så många öppningar, vilket är användbart för engångsnedladdningar.

Du kan pausa och återuppta en länk när som helst med linkdash links update q4-deck --status paused och --status active.

Kör ett A/B-test på en kortlänk

I Linkdash är varje länk en behållare för en eller flera varianter. En variant är ett mål (en URL, en fil eller en text) med egen vikt och egna regler. En vanlig länk har en enda variant som heter main. Lägg till fler så fördelar kortlänken trafiken mellan dem:

linkdash links create --slug launch \
  --variant control --url https://example.com/pricing \
  --variant annual-first --url "https://example.com/pricing?view=annual"

Flaggor efter varje --variant hör till den varianten fram till nästa. Trafiken fördelas efter vikt, som är 1 som standard, så exemplet ovan är ett 50/50-test. Ge en variant --weight 3 för att skicka tre gånger så mycket trafik till den.

Tilldelningen är fast som standard: en återkommande besökare får samma variant igen, vilket är vad du vill ha för ett rättvist test. När du ändrar experimentet blandar linkdash links update launch --restart-split om alla en gång.

En Linkdash-länk med två varianter, control och annual-first, som fördelar trafiken mellan två prissidor

Statistiken redovisas per variant, så du kan jämföra dem direkt:

linkdash links stats launch --last 7d

Arrayen variants i utdata visar visits, visitors, downloads och plays för varje variant. Mer om statistik längre ner.

Dirigera besökare efter land, enhet eller query-parameter

Varianter kan också ha villkor. Lägg till --when på en variant så kan bara besökare som matchar få den. Det gör en kortlänk till en router. Här är till exempel en länk som skickar mobiler till rätt appbutik:

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ökare öppnar länken bildar varianterna vars villkor matchar urvalet. Matchar ingen används varianterna utan villkor i stället, så web ovan fångar alla som inte använder iOS eller Android.

En Linkdash-länk som skickar besökare till App Store på iOS, Google Play på Android och en webbsida för alla andra

Du kan matcha på:

Nyckel Matchar Exempel
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åktaggar, efter prefix --when language=de
referrer Den hänvisande värden --when referrer=twitter.com

Upprepa --when för att kräva flera villkor samtidigt. --when country=DE,AT --when device=mobile matchar mobilbesökare från Tyskland eller Österrike.

Varianter kan också matcha besökarens query-sträng, så en och samma länk kan bete sig olika beroende på var du delade den. lida.sh/launch?src=newsletter kan skicka nyhetsbrevsläsare till ett särskilt ställe:

linkdash links variants add launch --name newsletter \
  --url https://example.com/pricing/newsletter \
  --when param:src=newsletter

Parameterregler stöder är lika med (=), är inte lika med (!=), innehåller (~=), börjar med (^=), slutar med ($=), är något av (=a|b), finns (param:ref?) och saknas (param:!ref). Vill du i stället att besökarens parametrar skickas vidare till målet skapar du länken med --forward-params.

Dashboarden har samma inställningar, med en landsväljare som söker på namn, så du behöver inte komma ihåg att Slovenien är SI:

Val av målländer för en variant i Linkdash-dashboarden, med Tyskland och Österrike valda

Läs klickstatistik från terminalen

linkdash links stats launch --last 7d

Utdata innehåller totalt antal visits, downloads och plays, antalet besök i perioden du bad om (visitsInLast), de countries och referrers som besöken kom från, en uppdelning per variant i variants och en visitors-lista med tid, land, enhet, webbläsare och hänvisare för varje nyligt besök. --last tar en tidsperiod som 24h eller 30d och är 24h som standard.

Linkdash sparar inte besökarnas IP-adresser. Adressen används för att slå upp besökarens land och för att ta fram en anonym besökaridentifierare som byts varje dag, och kastas sedan.

Vill du reagera på klick när de händer registrerar du en webhook. Linkdash skickar signerade händelser av typen link.visit, link.download och link.play till valfri HTTPS-endpoint:

linkdash webhooks create --url https://example.com/hooks

Signeringshemligheten skrivs bara ut en gång, så spara den direkt. Se dokumentationen om webhooks för hur du verifierar signaturer.

Låt AI-agenter skapa kortlänkar med MCP

Allt ovan är också tillgängligt för AI-agenter. Linkdash kör en fjärr-MCP-server på https://api.linkdash.dev/mcp, och dess verktyg speglar CLI:t: links_create, links_update, links_stats, variants_add, domains_add och resten, med samma JSON som svar.

Skapa en API-nyckel i dashboarden under API-nycklar och anslut sedan din agent. I Claude Code:

claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
  --header "Authorization: Bearer $LINKDASH_API_KEY"

I Cursor lägger du till den i .cursor/mcp.json:

{
  "mcpServers": {
    "linkdash": {
      "url": "https://api.linkdash.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
    }
  }
}

I Codex, som läser nyckeln från den miljövariabel du anger:

codex mcp add linkdash --url https://api.linkdash.dev/mcp \
  --bearer-token-env-var LINKDASH_API_KEY

Därefter kan du be om länkar med vanligt språk, till exempel ”korta https://example.com/pricing som pricing och tagga den med launch” eller ”vilken variant av launch fick flest besökare den här veckan?”, och agenten anropar rätt verktyg. MCP-dokumentationen beskriver också OpenCode.

Om din agent redan arbetar i en terminal kan den använda CLI:t direkt. Installera Linkdash agent-skill så att den kan kommandona och flaggorna:

npx skills add https://linkdash.dev/skills/linkdash/SKILL.md

Använd HTTP API:et

För din egen kod finns samma operationer som ett vanligt REST API på https://api.linkdash.dev/v1, autentiserat med samma API-nyckel:

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 samma form som utdata från CLI:t. API-referensen beskriver alla endpoints, inklusive filuppladdningar och varianter.

Använd din egen domän

Kortlänkar ligger på lida.sh som standard. Vill du i stället servera dem från din egen domän lägger du till den och pekar din DNS mot Linkdash:

linkdash domains add go.example.com
linkdash domains verify go.example.com

Skapa sedan länkar på den med --domain go.example.com. Varje egen domän har sin egen uppsättning slugs, så go.example.com/launch krockar inte med någon annans launch. Guiden om domäner går igenom DNS-konfigurationen, inklusive konfiguration med ett klick hos leverantörer som stöder det.

Priser

Free-planen kräver inget kreditkort och innehåller 5 000 händelser per månad, 1 GB fillagring, en månads statistikhistorik och en egen domän. En händelse är ett besök, en nedladdning eller en uppspelning på någon av dina länkar, eller en skrivning som att skapa eller uppdatera en länk. Läsningar som att lista länkar eller hämta statistik är gratis.

Betalplanerna höjer gränserna: Professional kostar 18 $ i månaden och Growth 48 $ i månaden. Se priser för en fullständig jämförelse.

Vanliga frågor

Finns det en gratis länkförkortare med CLI?

Ja. Linkdash CLI fungerar med Free-planen, som innehåller 5 000 händelser per månad utan kreditkort.

Kan jag använda Linkdash CLI i CI?

Ja. Sätt LINKDASH_TOKEN till en sessionstoken så körs CLI:t utan webbläsare. Eftersom varje kommando skriver ut JSON kan du skapa och uppdatera länkar från GitHub Actions eller någon annan pipeline och läsa resultaten med jq.

Kan AI-agenter skapa kortlänkar?

Ja, på tre sätt: via MCP-servern på https://api.linkdash.dev/mcp, via CLI:t med Linkdash agent-skill installerad eller via HTTP API:et. Alla tre ger tillgång till samma operationer och returnerar samma JSON.

Sparar Linkdash besökarnas IP-adresser?

Nej. Linkdash använder adressen för att slå upp besökarens land och skapa en anonym identifierare per dag, och kastar den sedan. Länkägare ser aldrig IP-adresser.

Kan en kortlänk skicka olika besökare till olika sidor?

Ja. Ge en länk flera varianter och lägg till villkor som land, enhet, operativsystem, språk, hänvisare eller query-parameter på var och en. Utan villkor fördelar varianterna trafiken efter vikt, och det är så du kör ett A/B-test.


Redo att testa? Installera CLI:t, kör linkdash auth create och korta din första länk på under en minut. Snabbstarten har alla steg.

Linkdash

© 2026 Igor Kirnosov s.p. Alla rättigheter förbehållna.