Naar inhoud
Alle artikelen

climcpapi

Een URL-shortener-CLI voor developers en AI-agents

Verkort URL’s vanaf de command line met de Linkdash CLI. Deel bestanden en fragmenten, doe A/B-tests, target bezoekers en laat AI-agents links beheren via MCP.

Igor Kirnosov9 min. lezen

Terminal die met het commando linkdash links create een korte Linkdash-link maakt

Linkdash is een URL-shortener die je vanuit de terminal bedient. Eén commando maakt van een URL, een bestand of een tekstfragment een korte link met tracking op lida.sh, en geeft het resultaat terug als JSON die je overal in kunt pipen. Dezelfde acties zijn beschikbaar via een HTTP API en als MCP-server, zodat een AI-agent links kan maken, bijwerken en meten met precies dezelfde tools die jij gebruikt.

Deze gids loopt de hele CLI door: installeren, je eerste link verkorten, bestanden delen, links afschermen, A/B-tests draaien, bezoekers routeren op land of apparaat, en statistieken lezen zonder een browser te openen.

Het Linkdash-dashboard met korte links en hun soort, slug, doel en status

De Linkdash CLI installeren

De CLI is een npm-pakket en heeft Node.js 20 of hoger nodig.

npm i -g linkdash-cli

Het werkt net zo met pnpm add -g linkdash-cli of bun add -g linkdash-cli. Het commando dat wordt geïnstalleerd, is linkdash.

Maak daarna in één stap een account en log de CLI in:

linkdash auth create

Dit opent de aanmeldpagina in je browser. Zodra je een account hebt, keur je de code goed die in je terminal staat, en de CLI is ingelogd. Heb je al een account, gebruik dan linkdash auth login. linkdash auth whoami laat zien welk account je gebruikt, en de CLI-referentie bevat elk commando en elke flag.

De sessie wordt opgeslagen in ~/.config/linkdash/config.json, met rechten die alleen de eigenaar toegang geven. Voor CI of andere headless omgevingen zet je LINKDASH_TOKEN op de sessietoken uit dat bestand op een machine waar je bent ingelogd. Behandel die als elk ander secret.

Een URL verkorten vanaf de command line

linkdash links create --url https://example.com/pricing --slug pricing
{
  "id": "pricing",
  "url": "https://lida.sh/pricing",
  "kind": "url",
  "variants": [
    { "name": "main", "kind": "url" }
  ]
}

Dat is de hele interface: geslaagde commando’s schrijven JSON naar stdout, en fouten schrijven platte tekst naar stderr met exitcode 1. Er is geen --json-flag, omdat JSON de enige uitvoer is. Daardoor is de CLI makkelijk te scripten. Zo kopieer je op macOS een nieuwe korte link direct naar je klembord:

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

Een paar flags die je steeds zult gebruiken:

  • --slug bepaalt het openbare pad. Slugs bestaan uit kleine letters, cijfers en koppeltekens daartussen, tot 64 tekens. Laat je hem weg, dan genereert Linkdash er een.
  • --name is een privélabel dat alleen jij ziet, handig om links later terug te vinden.
  • --tag kun je herhalen, dus --tag launch --tag q4 geeft een link twee tags.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term en --utm-content voegen campagneparameters toe aan de bestemming.

Bekijk en doorzoek wat je hebt gemaakt met linkdash links list --q pricing --tag launch.

Een bestand of tekstfragment delen

Korte links zijn er niet alleen voor URL’s. Hetzelfde commando uploadt een bestand of slaat een fragment op:

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

Een bestandslink geeft bezoekers een download, met een voorbeeld voor afbeeldingen en video. Een tekstlink toont het fragment op een pagina met een kopieerknop. Beide worden getrackt zoals elke andere link, dus je ziet wie je presentatie heeft geopend en wanneer. Zo vervang je het bestand achter een bestaande link zonder de URL te wijzigen:

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

Elke link kan zijn eigen toegangsregels hebben:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • --password vraagt bezoekers om een wachtwoord voordat de link opent.
  • --starts en --expires accepteren een duur zoals 30m, 24h of 7d, of een ISO-datum. Vóór de starttijd werkt een link helemaal niet.
  • --max-openings pauzeert de link na zoveel openingen, handig voor eenmalige downloads.

Je kunt een link altijd pauzeren en hervatten met linkdash links update q4-deck --status paused en --status active.

In Linkdash is elke link een container van een of meer varianten. Een variant is een bestemming (een URL, bestand of tekst) met een eigen gewicht en eigen regels. Een normale link heeft één variant met de naam main. Voeg er meer toe en de korte link verdeelt zijn verkeer over die varianten:

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

Flags na elke --variant horen bij die variant, tot de volgende. Verkeer wordt verdeeld op gewicht, dat standaard 1 is, dus het voorbeeld hierboven is een 50/50-test. Geef een variant --weight 3 om hem drie keer zoveel verkeer te sturen.

De toewijzing is standaard vast: een terugkerende bezoeker krijgt steeds dezelfde variant, en dat wil je voor een eerlijke test. Pas je het experiment aan, dan schudt linkdash links update launch --restart-split iedereen één keer opnieuw.

Een Linkdash-link met twee varianten, control en annual-first, die het verkeer verdeelt over twee prijspagina’s

Statistieken komen per variant terug, zodat je ze direct kunt vergelijken:

linkdash links stats launch --last 7d

De array variants in de uitvoer geeft per variant visits, visitors, downloads en plays. Meer over statistieken hieronder.

Bezoekers routeren op land, apparaat of queryparameter

Varianten kunnen ook voorwaarden hebben. Voeg --when toe aan een variant en alleen bezoekers die daaraan voldoen, kunnen hem krijgen. Zo wordt één korte link een router. Bijvoorbeeld één link die telefoons naar de juiste app store stuurt:

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

Als een bezoeker de link opent, vormen de varianten waarvan de voorwaarden kloppen de pool. Klopt er geen enkele, dan worden de varianten zonder voorwaarden gebruikt, dus web hierboven vangt iedereen op die niet op iOS of Android zit.

Een Linkdash-link die bezoekers op iOS naar de App Store stuurt, op Android naar Google Play en alle anderen naar een webpagina

Je kunt matchen op:

Sleutel Matcht Voorbeeld
country ISO-landcodes --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 Taaltags, op prefix --when language=de
referrer De verwijzende host --when referrer=twitter.com

Herhaal --when om meerdere voorwaarden tegelijk te eisen. --when country=DE,AT --when device=mobile matcht mobiele bezoekers uit Duitsland of Oostenrijk.

Varianten kunnen ook matchen op de querystring van de bezoeker, zodat één link zich anders gedraagt afhankelijk van waar je hem hebt gedeeld. lida.sh/launch?src=newsletter kan lezers van je nieuwsbrief naar een speciale pagina sturen:

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

Parameterregels ondersteunen is gelijk aan (=), is niet gelijk aan (!=), bevat (~=), begint met (^=), eindigt op ($=), is een van (=a|b), aanwezig (param:ref?) en ontbreekt (param:!ref). Wil je de parameters van de bezoeker juist doorgeven aan de bestemming, maak de link dan met --forward-params.

Het dashboard heeft dezelfde opties, met een landkiezer die op naam zoekt, zodat je niet hoeft te onthouden dat Slovenië SI is:

Doellanden kiezen voor een variant in het Linkdash-dashboard, met Duitsland en Oostenrijk geselecteerd

Klikstatistieken lezen in de terminal

linkdash links stats launch --last 7d

De uitvoer bevat het totaal aan visits, downloads en plays, het aantal bezoeken in de periode die je opvroeg (visitsInLast), de countries en referrers waar die bezoeken vandaan kwamen, een uitsplitsing per variants, en een lijst visitors met de tijd, het land, het apparaat, de browser en de referrer van elk recent bezoek. --last accepteert een duur zoals 24h of 30d en is standaard 24h.

Linkdash slaat geen IP-adressen van bezoekers op. Het adres wordt gebruikt om het land van de bezoeker op te zoeken en om een anonieme bezoekers-id af te leiden die dagelijks verandert, en daarna weggegooid.

Wil je op klikken reageren terwijl ze binnenkomen, registreer dan een webhook. Linkdash stuurt ondertekende events link.visit, link.download en link.play naar elk HTTPS-endpoint:

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

Het signing secret wordt één keer getoond, dus bewaar het meteen. In de webhookdocs lees je hoe je handtekeningen verifieert.

Alles hierboven is ook beschikbaar voor AI-agents. Linkdash draait een remote MCP-server op https://api.linkdash.dev/mcp, en de tools volgen de CLI: links_create, links_update, links_stats, variants_add, domains_add en de rest, met dezelfde JSON als resultaat.

Maak in het dashboard een API-sleutel aan onder API-sleutels en koppel daarna je agent. In Claude Code:

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

In Cursor voeg je hem toe aan .cursor/mcp.json:

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

In Codex, dat de sleutel leest uit de omgevingsvariabele die je opgeeft:

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

Vanaf dan kun je in gewone taal om links vragen, bijvoorbeeld ‘verkort https://example.com/pricing als pricing en tag hem met launch’ of ‘welke variant van launch had deze week meer bezoekers?’, en de agent roept de juiste tool aan. De MCP-docs behandelen ook OpenCode.

Werkt je agent al in een terminal, dan kan hij de CLI direct gebruiken. Installeer de Linkdash-agentskill, zodat hij de commando’s en flags kent:

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

De HTTP API gebruiken

Voor je eigen code zijn dezelfde acties beschikbaar als een gewone REST API op https://api.linkdash.dev/v1, met dezelfde API-sleutel voor authenticatie:

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" }'

Het antwoord heeft dezelfde vorm als de uitvoer van de CLI. De API-referentie behandelt elk endpoint, inclusief bestandsuploads en varianten.

Je eigen domein gebruiken

Korte links staan standaard op lida.sh. Wil je ze vanaf je eigen domein serveren, voeg het dan toe en laat je DNS naar Linkdash wijzen:

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

Maak er daarna links op met --domain go.example.com. Elk eigen domein heeft zijn eigen set slugs, dus go.example.com/launch botst niet met de launch van iemand anders. De domeinengids behandelt de DNS-instellingen, inclusief instellen met één klik bij providers die dat ondersteunen.

Prijzen

Voor het Free-abonnement heb je geen creditcard nodig. Het bevat 5.000 events per maand, 1 GB bestandsopslag, één maand statistiekengeschiedenis en één eigen domein. Een event is een bezoek, download of afspeelbeurt op een van je links, of een schrijfactie zoals een link maken of bijwerken. Leesacties zoals links weergeven of statistieken ophalen zijn gratis.

Betaalde abonnementen verhogen die limieten: Professional kost $ 18 per maand en Growth $ 48 per maand. Zie prijzen voor de volledige vergelijking.

FAQ

Is er een gratis URL-shortener met een CLI?

Ja. De Linkdash CLI werkt met het Free-abonnement, met 5.000 events per maand en zonder creditcard.

Kan ik de Linkdash CLI in CI gebruiken?

Ja. Zet LINKDASH_TOKEN op een sessietoken en de CLI draait zonder browser. Omdat elk commando JSON teruggeeft, kun je links maken en bijwerken vanuit GitHub Actions of elke andere pipeline en de resultaten lezen met jq.

Ja, op drie manieren: via de MCP-server op https://api.linkdash.dev/mcp, via de CLI met de Linkdash-agentskill geïnstalleerd, of via de HTTP API. Alle drie bieden dezelfde acties en geven dezelfde JSON terug.

Slaat Linkdash IP-adressen van bezoekers op?

Nee. Linkdash gebruikt het adres om het land van de bezoeker op te zoeken en een dagelijkse anonieme id te maken, en gooit het daarna weg. Eigenaren van links zien nooit IP-adressen.

Ja. Geef een link meerdere varianten en voeg aan elke variant voorwaarden toe, zoals land, apparaat, besturingssysteem, taal, referrer of queryparameter. Zonder voorwaarden verdelen varianten het verkeer op gewicht, en zo draai je een A/B-test.


Klaar om het te proberen? Installeer de CLI, voer linkdash auth create uit en verkort je eerste link in minder dan een minuut. De quickstart bevat alle stappen.