climcpapi
URL-Shortener-CLI für Entwickler und KI-Agents
Kürze URLs in der Kommandozeile mit der Linkdash-CLI. Teile Dateien und Snippets, mach A/B-Tests, target Besucher und lass KI-Agents Links per MCP verwalten.
Igor Kirnosov9 Min. Lesezeit

Linkdash ist ein URL-Shortener, den du aus dem Terminal steuerst. Ein Befehl macht aus einer URL, einer Datei oder einem Text-Snippet einen getrackten Kurzlink auf lida.sh und gibt das Ergebnis als JSON aus, das du überallhin weiterleiten kannst. Dieselben Operationen gibt es über eine HTTP-API und als MCP-Server, sodass ein KI-Agent Links mit genau denselben Tools erstellen, ändern und auswerten kann, die du nutzt.
Diese Anleitung geht die ganze CLI durch: Installation, der erste Kurzlink, Dateien teilen, Links absichern, A/B-Tests, Besucher nach Land oder Gerät routen und Statistiken lesen, ohne einen Browser zu öffnen.

Die Linkdash-CLI installieren
Die CLI ist ein npm-Paket und braucht Node.js 20 oder neuer.
npm i -g linkdash-cli
Mit pnpm add -g linkdash-cli oder bun add -g linkdash-cli funktioniert es genauso. Der installierte Befehl heißt linkdash.
Erstelle dann in einem Schritt ein Konto und melde die CLI an:
linkdash auth create
Damit öffnet sich die Registrierungsseite in deinem Browser. Sobald du ein Konto hast, bestätigst du den Code, der in deinem Terminal angezeigt wird, und die CLI ist angemeldet. Wenn du schon ein Konto hast, nutze stattdessen linkdash auth login. linkdash auth whoami zeigt, welches Konto du verwendest, und die CLI-Referenz listet alle Befehle und Flags.
Die Sitzung wird in ~/.config/linkdash/config.json mit Berechtigungen nur für den Eigentümer gespeichert. Für CI oder andere Headless-Umgebungen setzt du LINKDASH_TOKEN auf das Sitzungstoken aus dieser Datei auf einem Rechner, auf dem du angemeldet bist, und behandelst es wie jedes andere Secret.
Eine URL in der Kommandozeile kürzen
linkdash links create --url https://example.com/pricing --slug pricing
{
"id": "pricing",
"url": "https://lida.sh/pricing",
"kind": "url",
"variants": [
{ "name": "main", "kind": "url" }
]
}
Das ist die ganze Schnittstelle: Erfolgreiche Befehle geben JSON auf stdout aus, Fehler erscheinen als Klartext auf stderr mit Exit-Code 1. Es gibt kein --json-Flag, weil JSON die einzige Ausgabe ist. Dadurch lässt sich die CLI leicht in Skripte einbauen. So kopierst du unter macOS einen frischen Kurzlink direkt in die Zwischenablage:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Ein paar Flags, die du ständig brauchen wirst:
--sluglegt den öffentlichen Pfad fest. Slugs bestehen aus Kleinbuchstaben, Ziffern und Bindestrichen dazwischen, bis zu 64 Zeichen. Lässt du ihn weg, generiert Linkdash einen.--nameist ein privates Label, das nur du siehst – praktisch, um Links später wiederzufinden.--tagist wiederholbar,--tag launch --tag q4vergibt also zwei Tags.--utm-source,--utm-medium,--utm-campaign,--utm-termund--utm-contenthängen Kampagnenparameter an das Ziel an.
Mit linkdash links list --q pricing --tag launch listest und durchsuchst du, was du erstellt hast.
Eine Datei oder ein Text-Snippet teilen
Kurzlinks sind nicht nur für URLs da. Derselbe Befehl lädt eine Datei hoch oder speichert ein Snippet:
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
Ein Datei-Link bietet Besuchern einen Download, mit Vorschau für Bilder und Videos. Ein Text-Link zeigt das Snippet auf einer Seite mit Kopier-Button. Beide werden wie jeder andere Link getrackt, du siehst also, wer dein Deck wann geöffnet hat. So ersetzt du die Datei hinter einem bestehenden Link, ohne die URL zu ändern:
linkdash links update board-deck --file ./board-deck-v2.pdf
Festlegen, wer einen Link öffnen kann
Jeder Link kann eigene Zugangsregeln haben:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordfragt Besucher nach einem Passwort, bevor sich der Link öffnet.--startsund--expiresnehmen eine Dauer wie30m,24hoder7doder ein ISO-Datum. Vor seiner Startzeit löst ein Link überhaupt nicht auf.--max-openingspausiert den Link nach so vielen Öffnungen – nützlich für einmalige Downloads.
Mit linkdash links update q4-deck --status paused und --status active kannst du einen Link jederzeit pausieren und fortsetzen.
Einen A/B-Test mit einem Kurzlink durchführen
In Linkdash ist jeder Link ein Container für eine oder mehrere Varianten. Eine Variante ist ein Ziel (eine URL, Datei oder ein Text) mit eigener Gewichtung und eigenen Regeln. Ein normaler Link hat eine einzige Variante namens main. Fügst du weitere hinzu, teilt der Kurzlink seinen Traffic auf sie auf:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
Flags nach einem --variant gehören zu dieser Variante, bis die nächste beginnt. Der Traffic wird nach Gewichtung aufgeteilt, standardmäßig 1, das Beispiel oben ist also ein 50/50-Test. Gib einer Variante --weight 3, um ihr dreimal so viel Traffic zu schicken.
Die Zuordnung ist standardmäßig fest: Ein wiederkehrender Besucher bekommt immer wieder dieselbe Variante – genau das willst du für einen fairen Test. Wenn du das Experiment änderst, mischt linkdash links update launch --restart-split alle einmal neu.

Statistiken kommen pro Variante zurück, du kannst sie also direkt vergleichen:
linkdash links stats launch --last 7d
Das Array variants in der Ausgabe meldet visits, visitors, downloads und plays für jede Variante. Mehr zu Statistiken weiter unten.
Besucher nach Land, Gerät oder Query-Parameter routen
Varianten können auch Bedingungen haben. Füge einer Variante --when hinzu, und nur passende Besucher können sie bekommen. So wird aus einem Kurzlink ein Router – zum Beispiel ein Link, der Smartphones in den richtigen App Store schickt:
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
Wenn ein Besucher den Link öffnet, bilden die Varianten mit passenden Bedingungen den Pool. Passt keine, werden stattdessen die Varianten ohne Bedingungen genutzt – web fängt oben also alle auf, die weder iOS noch Android nutzen.

Du kannst auf Folgendes prüfen:
| Schlüssel | Trifft zu auf | Beispiel |
|---|---|---|
country |
ISO-Ländercodes | --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 |
Sprach-Tags, nach Präfix | --when language=de |
referrer |
Den verweisenden Host | --when referrer=twitter.com |
Wiederhole --when, um mehrere Bedingungen gleichzeitig zu verlangen. --when country=DE,AT --when device=mobile trifft auf mobile Besucher aus Deutschland oder Österreich zu.
Varianten können auch auf den Query-String des Besuchers prüfen, sodass sich ein einziger Link je nachdem, wo du ihn geteilt hast, unterschiedlich verhält. lida.sh/launch?src=newsletter kann Newsletter-Leser an eine besondere Stelle schicken:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
Parameterregeln unterstützen ist gleich (=), ist nicht (!=), enthält (~=), beginnt mit (^=), endet mit ($=), ist eines von (=a|b), vorhanden (param:ref?) und fehlt (param:!ref). Wenn die Parameter des Besuchers stattdessen an das Ziel weitergereicht werden sollen, erstelle den Link mit --forward-params.
Das Dashboard bietet dieselben Einstellungen, mit einer Länderauswahl, die nach Namen sucht – du musst dir also nicht merken, dass Slowenien SI ist:

Klick-Statistiken im Terminal lesen
linkdash links stats launch --last 7d
Die Ausgabe enthält die Gesamtzahl der visits, downloads und plays, die Zahl der Aufrufe im angefragten Zeitraum (visitsInLast), die countries und referrers, aus denen diese Aufrufe kamen, eine Aufschlüsselung nach variants und eine Liste visitors mit Zeit, Land, Gerät, Browser und Referrer jedes aktuellen Aufrufs. --last nimmt eine Dauer wie 24h oder 30d, Standard ist 24h.
Linkdash speichert keine IP-Adressen von Besuchern. Die Adresse wird genutzt, um das Land des Besuchers zu ermitteln und eine anonyme Besucherkennung abzuleiten, die sich täglich ändert – danach wird sie verworfen.
Um auf Klicks in Echtzeit zu reagieren, registriere einen Webhook. Linkdash schickt signierte Events link.visit, link.download und link.play an jeden HTTPS-Endpunkt:
linkdash webhooks create --url https://example.com/hooks
Das Signing-Secret wird nur einmal ausgegeben, speichere es also sofort. In der Webhook-Doku steht, wie du Signaturen prüfst.
KI-Agents per MCP Kurzlinks erstellen lassen
Alles oben Beschriebene steht auch KI-Agents zur Verfügung. Linkdash betreibt einen Remote-MCP-Server unter https://api.linkdash.dev/mcp, und seine Tools spiegeln die CLI: links_create, links_update, links_stats, variants_add, domains_add und so weiter, mit demselben JSON als Rückgabe.
Erstelle im Dashboard unter API-Keys einen API-Key und verbinde dann deinen Agent. In Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
In Cursor fügst du ihn zu .cursor/mcp.json hinzu:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
In Codex, das den Key aus der angegebenen Umgebungsvariable liest:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
Ab dann kannst du Links in normaler Sprache anfordern, etwa „Kürze https://example.com/pricing als pricing und tagge ihn mit launch“ oder „Welche Variante von launch hatte diese Woche mehr Besucher?“, und der Agent ruft das passende Tool auf. Die MCP-Doku behandelt auch OpenCode.
Arbeitet dein Agent ohnehin im Terminal, kann er die CLI direkt nutzen. Installiere den Linkdash-Agent-Skill, damit er die Befehle und Flags kennt:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Die HTTP-API nutzen
Für deinen eigenen Code gibt es dieselben Operationen als schlichte REST-API unter https://api.linkdash.dev/v1, authentifiziert mit demselben API-Key:
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" }'
Die Antwort hat dieselbe Struktur wie die CLI-Ausgabe. Die API-Referenz behandelt jeden Endpunkt, einschließlich Datei-Uploads und Varianten.
Deine eigene Domain nutzen
Kurzlinks liegen standardmäßig auf lida.sh. Um sie stattdessen über deine eigene Domain auszuliefern, füge sie hinzu und lass dein DNS auf Linkdash zeigen:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Erstelle dann Links darauf mit --domain go.example.com. Jede eigene Domain hat ihre eigenen Slugs, go.example.com/launch kollidiert also nicht mit dem launch von jemand anderem. Die Domain-Anleitung behandelt die DNS-Einrichtung, einschließlich der Ein-Klick-Einrichtung für Anbieter, die sie unterstützen.
Preise
Der Free-Tarif braucht keine Kreditkarte und enthält 5.000 Events pro Monat, 1 GB Dateispeicher, einen Monat Statistik-Verlauf und eine eigene Domain. Ein Event ist ein Aufruf, Download oder eine Wiedergabe eines deiner Links oder ein Schreibvorgang wie das Erstellen oder Ändern eines Links. Lesevorgänge wie das Auflisten von Links oder das Abrufen von Statistiken sind kostenlos.
Kostenpflichtige Tarife heben diese Limits an: Professional kostet 18 $ pro Monat, Growth 48 $ pro Monat. Den vollständigen Vergleich findest du unter Preise.
FAQ
Gibt es einen kostenlosen URL-Shortener mit CLI?
Ja. Die Linkdash-CLI funktioniert im Free-Tarif, der 5.000 Events pro Monat enthält – ohne Kreditkarte.
Kann ich die Linkdash-CLI in der CI nutzen?
Ja. Setze LINKDASH_TOKEN auf ein Sitzungstoken, und die CLI läuft ohne Browser. Weil jeder Befehl JSON ausgibt, kannst du Links aus GitHub Actions oder jeder anderen Pipeline erstellen und ändern und die Ergebnisse mit jq auslesen.
Können KI-Agents Kurzlinks erstellen?
Ja, auf drei Wegen: über den MCP-Server unter https://api.linkdash.dev/mcp, über die CLI mit installiertem Linkdash-Agent-Skill oder über die HTTP-API. Alle drei bieten dieselben Operationen und liefern dasselbe JSON.
Speichert Linkdash IP-Adressen von Besuchern?
Nein. Linkdash nutzt die Adresse, um das Land des Besuchers zu ermitteln und eine tägliche anonyme Kennung zu erzeugen, und verwirft sie dann. Link-Eigentümer sehen nie IP-Adressen.
Kann ein Kurzlink verschiedene Besucher auf verschiedene Seiten schicken?
Ja. Gib einem Link mehrere Varianten und versieh jede mit Bedingungen wie Land, Gerät, Betriebssystem, Sprache, Referrer oder Query-Parameter. Ohne Bedingungen teilen Varianten den Traffic nach Gewichtung auf – so führst du einen A/B-Test durch.
Bereit zum Ausprobieren? Installiere die CLI, führe linkdash auth create aus und kürze deinen ersten Link in unter einer Minute. Der Schnellstart enthält alle Schritte.

