npm i -g @linktwin/cli

LinkTwin CLI: Links über die Kommandozeile kürzen und verwalten.

Die LinkTwin CLI bringt Kurzlinks und Deep Links in Ihr Terminal. Erstellen, bearbeiten und analysieren Sie Links, verwalten Sie QR-Codes, Sammlungen, Domains und Pixel, und automatisieren Sie alles mit einfachen Befehlen und JSON-Ausgabe. Gebaut für Entwickler, Skripte und CI.

npm install -g @linktwin/cli
Alle Befehle ansehen
  • Node.js 18 oder neuer
  • MIT-lizenziert, auf npm
  • Skriptfähig mit --json
maya@studio: ~/links

Beispielsitzung mit echten Befehlen und Ausgabeformaten.

Für Entwickler gemacht

Schluss mit dem Kontextwechsel, nur um einen Link zu kürzen.

Sie leben im Terminal. Ein Dashboard zu öffnen, um einen Link zu erstellen, oder API-Aufrufe für ein schnelles Skript von Hand zu schreiben, bremst Sie aus. Die LinkTwin-CLI bringt Linkerstellung, Deep Linking und Analysen auf nur einen Befehl Entfernung.

Schritte bis zum Ziel

  • Dashboard
  • LinkTwin CLI
Link mit einem Alias kürzen
Ihre meistgeklickten Links auflisten
Gezählt für jemanden, der bereits angemeldet ist und ein Terminal offen hat. Jeder Block ist eine Aktion.
Die Aufgabe Der alte Weg Mit der LinkTwin-CLI
Einen Link erstellen Das Terminal für das Dashboard verlassen linktwin links create <url>
Anmeldung curl + Auth für jedes Skript schreiben Einmal anmelden, dann nur noch Befehle
Massenbearbeitung Keine einfachen Massenoperationen Massenhaft erstellen & löschen – ganz einfach
Automatisierung Schwer in CI zu integrieren --json + Umgebungsvariable = bereit für CI

Loslegen

Mit zwei Befehlen einsatzbereit

Erfordert Node.js 18+. Ihr API-Schlüssel wird lokal in ~/.linktwin/config.json gespeichert.

Terminal 
# 1. Installieren (Node.js 18 oder neuer)
npm install -g @linktwin/cli

# 2. Authentifizieren (API-Schlüssel einfügen)
linktwin login

# 3. Ersten Link erstellen
linktwin links create https://example.com --custom hello

Sie nutzen KI? Probieren Sie den MCP-Server aus. Sie schreiben eine eigene Integration? Lesen Sie die API-Dokumentation.

Woher Ihr API-Schlüssel kommt

Die CLI sucht Zugangsdaten in dieser Reihenfolge und nutzt die ersten, die sie findet, sodass ein CI-Job Ihre gespeicherte Anmeldung überschreiben kann, ohne sie anzutasten.

  1. Flags--api-key --base-url
  2. UmgebungsvariablenLINKTWIN_API_KEY LINKTWIN_BASE_URL
  3. Gespeicherte Anmeldung~/.linktwin/config.json, geschrieben von linktwin login und nur für Sie lesbar (Modus 0600).
  4. Standard-Basis-URLhttps://linktw.in

Befehle

Alles, mit einem Befehl

Ein gezielter Befehl für jeden Teil Ihres Link-Workflows. Jeder Befehl akzeptiert außerdem die globalen Optionen --json, --api-key, --base-url.

linktwin stats

Analysen pro Link und für das gesamte Konto: Klicks, Länder, Referrer, Geräte und Trends.

  • linktwin stats link <id>

    Analysen für einen einzelnen Link (ID oder Kurz-URL)

    • --timezone
  • linktwin stats dashboard

    Zusammengefasste Konto-KPIs und Klicktrend

    • -p, --period 1d|1w|1m|1y|max
    • --timezone
  • linktwin stats detailed

    Detaillierte Kontoanalysen mit Aufschlüsselungen

    • -r, --range 1d|7d|30d|max|custom
    • --start
    • --end
    • --collections
    • --timezone
  • linktwin stats trend

    Klickverteilung nach Stunde oder Tag (Tagestrend)

    • -p, --period
    • --timezone
Beispielausgabe 
$ linktwin stats dashboard --period 1m
Dashboard
Total clicks:  4370
Unique clicks: 3915
Top country:   United States
Top referrer:  https://l.instagram.com
Total links:   9
Growth %:      64.22

linktwin collections

Organisieren Sie Links in Sammlungen und weisen Sie Links massenhaft zu.

  • linktwin collections list

    Sammlungen auflisten

    • -l, --limit
    • --page
  • linktwin collections get <id>

    Einträge einer Sammlung auflisten

    • -l, --limit
    • --page
  • linktwin collections create <name>

    Sammlung erstellen

    • --description
    • --color <hex>
    • --slug
    • --public
    • --starred
  • linktwin collections update <id>

    Sammlung aktualisieren

    • --name
    • --description
    • --color
    • --public <bool>
    • --starred <bool>
  • linktwin collections assign <collectionId> <linkIds>

    Links zu einer Sammlung hinzufügen oder daraus entfernen (kommagetrennte Link-IDs)

    • --remove
  • linktwin collections delete <id>

    Sammlung löschen (Einträge werden nur entfernt, nicht gelöscht)

    • -y, --yes
Beispielausgabe 
$ linktwin collections assign 4 1221,1222,1223
✓ Added 3, removed 0 link(s).

linktwin domains

Fügen Sie Ihre eigenen, gebrandeten Domains hinzu und verwalten Sie sie.

  • linktwin domains list

    Alle verfügbaren Domains auflisten (Standard + Marken-Domains)

    • -l, --limit
    • --page
  • linktwin domains add <domain>

    Eine Marken-Domain hinzufügen (mit http:// oder https://)

    • --redirect-root
    • --redirect-404
  • linktwin domains update <id>

    Marken-Domain aktualisieren

    • --redirect-root
    • --redirect-404
  • linktwin domains delete <id>

    Marken-Domain löschen

    • -y, --yes
Beispielausgabe 
$ linktwin domains add https://go.mayamakes.shop --redirect-root https://mayamakes.shop
✓ Added domain https://go.mayamakes.shop (id 12).

linktwin pixels

Erstellen Sie Retargeting-Pixel und hängen Sie sie an Links an.

  • linktwin pixels list

    Retargeting-Pixel auflisten

    • -l, --limit
    • --page
  • linktwin pixels get <id>

    Pixel und seine zugewiesenen Links anzeigen

    • -l, --limit
    • --page
  • linktwin pixels create

    Retargeting-Pixel erstellen

    • -t, --type fbpixel|gtmpixel|…
    • -n, --name
    • --tag
    • --event
  • linktwin pixels update <id>

    Pixel aktualisieren

    • --tag
    • -n, --name
    • --event
  • linktwin pixels assign <pixelId> <linkIds>

    Ein Pixel zu Links hinzufügen oder entfernen (kommagetrennte Link-IDs)

    • --remove
  • linktwin pixels delete <id>

    Pixel löschen

    • -y, --yes
Beispielausgabe 
$ linktwin pixels create --type fbpixel --name "Meta pixel" --tag 1234567890
✓ Created pixel Meta pixel (id 4).

linktwin qr

Generieren und verwalten Sie QR-Codes für jeden Link.

  • linktwin qr list

    QR-Codes auflisten

    • -l, --limit
    • --page
  • linktwin qr get <id>

    QR-Code und seine Scan-Analysen anzeigen

  • linktwin qr create

    QR-Code erstellen

    • -t, --type text|vcard|link|email|phone|sms|wifi
    • -d, --data
    • --background
    • --foreground
    • --logo
  • linktwin qr update <id>

    QR-Code aktualisieren

    • -d, --data
    • --background
    • --foreground
    • --logo
  • linktwin qr delete <id>

    QR-Code löschen

    • -y, --yes
Beispielausgabe 
$ linktwin qr create --type link --data https://linktw.in/desk-tour
✓ Created QR code https://linktw.in/qr/a58f79 (id 3).

Konto

Speichern Sie Ihren Schlüssel einmal, prüfen Sie, welches Konto Sie nutzen, und sehen Sie, woher Ihre Zugangsdaten stammen.

  • linktwin login

    Ihren LinkTwin-API-Schlüssel und die Basis-URL speichern

    • -k, --key
    • -u, --url
    • --no-verify
  • linktwin logout

    Gespeicherte Zugangsdaten entfernen

  • linktwin whoami

    Aktuelles Konto, Tarif und Nutzung anzeigen

  • linktwin config

    Anzeigen, woher Zugangsdaten gelesen werden

Beispielausgabe 
$ linktwin whoami
Account
Email:      [email protected]
Plan:       Large
User ID:    57842
Links used: 9
Clicks:     4370
Base URL:   https://linktw.in

Gebaut für Skripte, Cronjobs und CI.

Dieselben Befehle funktionieren in einem Shell-Skript, einem geplanten Job oder einer Build-Pipeline. Fügen Sie --json für parsebare Ausgabe hinzu und übergeben Sie Ihren Schlüssel als Umgebungsvariable.

  • --json gibt bei jedem Befehl die rohe API-Antwort aus, bereit für jq.
  • LINKTWIN_API_KEY und LINKTWIN_BASE_URL überschreiben die gespeicherte Anmeldung, sodass CI nie linktwin login braucht.
  • Löschbefehle laufen nur mit --yes, damit ein Skript niemals versehentlich Links entfernt.
  • Jeder Fehler beendet mit Code 1 und gibt den Grund auf stderr aus, sodass ein fehlgeschlagener Schritt Ihre Pipeline stoppt.
jq 
# Ihre 5 meistgeklickten Links, mit Klicks und Kurz-URL
linktwin links list --order clicks_desc --limit 5 --json \
  | jq -r '.data.urls[] | "\(.clicks)\t\(.shorturl)"'
Massenerstellung 
# Ein Kurzlink für jede URL in urls.txt
while read -r url; do
  linktwin links create "$url" --json | jq -r '.shorturl'
done < urls.txt
Targeting 
# Geo-Targeting und UTM-Parameter, als JSON übergeben
linktwin links create https://example.com --custom promo \
  --data '{"geotarget":[{"location":"Canada","link":"https://example.ca"}],
           "parameters":[{"name":"utm_source","value":"newsletter"}]}'
GitHub Actions 
# Ein Workflow-Schritt: ein Kurzlink für jedes Release
- name: Short link for the release notes
  env:
    LINKTWIN_API_KEY: ${{ secrets.LINKTWIN_API_KEY }}
  run: |
    npm install -g @linktwin/cli
    linktwin links create "https://example.com/releases/${{ github.ref_name }}" --json

Fragen zur CLI

Alles über das LinkTwin-Kommandozeilentool. Noch Fragen? Kontaktieren Sie uns.

Was ist die LinkTwin-CLI?

Die LinkTwin CLI ist ein Kommandozeilentool, der Befehl linktwin, zum Kürzen und Verwalten von Links aus Ihrem Terminal. Sie können Kurzlinks und Deep Links erstellen, Sammlungen, Marken-Domains, Retargeting-Pixel und QR-Codes verwalten und Klick-Analysen abrufen, ohne das Dashboard zu öffnen. Jeder Befehl unterstützt --json-Ausgabe für Skripte und Automatisierung.

Wie installiere ich die LinkTwin-CLI?

Installieren Sie sie über npm mit npm install -g @linktwin/cli. Sie benötigt Node.js 18 oder neuer. Führen Sie dann linktwin login aus, fügen Sie Ihren API-Schlüssel ein, und schon können Sie Links über die Kommandozeile erstellen.

Ist die URL-Shortener-CLI kostenlos?

Die CLI selbst ist kostenlos und MIT-lizenziert. Sie arbeitet über die LinkTwin API, und API-Zugriff gibt es in jedem Tarif. Sie können zuerst ein kostenloses Konto erstellen und upgraden, wenn Sie die API brauchen.

Kann ich die CLI in Skripten und in CI verwenden?

Ja. Übergeben Sie --json an jeden Befehl, um maschinenlesbare Ausgabe zu erhalten, die Sie an jq weiterleiten können, und authentifizieren Sie sich ohne Eingabeaufforderung über die Umgebungsvariable LINKTWIN_API_KEY. Damit eignet sich die CLI gut für Build-Pipelines, Cronjobs und die Massenerstellung von Links.

Kann die CLI Deep Links erstellen, nicht nur Kurzlinks?

Ja. Jeder Link, den Sie erstellen, öffnet auf dem Handy die richtige App, etwa YouTube, Amazon oder Spotify. Die CLI setzt außerdem Geo-, Geräte- und Sprach-Targeting, A/B-Tests, UTM-Parameter und Marken-Domains. Erweitertes Targeting übergeben Sie als JSON mit dem Flag --data.

Wo erhalte ich meinen API-Schlüssel?

Melden Sie sich bei LinkTwin an und öffnen Sie in Ihrem Dashboard die Einstellungen oder Tools & Integrationen und dann CLI-Tool. Kopieren Sie Ihren API-Schlüssel und führen Sie linktwin login aus, oder setzen Sie ihn als Umgebungsvariable LINKTWIN_API_KEY. Der Schlüssel wird angezeigt, sobald Ihr Tarif API-Zugriff enthält.

Welche Befehle hat die LinkTwin CLI?

login, logout, whoami und config für Ihre Zugangsdaten, dazu sechs Befehlsgruppen: links, stats, collections, domains, pixels und qr. Führen Sie linktwin gefolgt von einem Befehl und --help aus, um alle Optionen zu sehen.

Wie verweise ich in einem Befehl auf einen Link?

Verwenden Sie seine numerische ID oder seine Kurz-URL, zum Beispiel linktwin stats link linktw.in/desk-tour. Die Kurz-URL funktioniert mit oder ohne https://. Beides finden Sie in der Ausgabe von linktwin links list.

Ein API-Schlüssel, drei Wege zum Entwickeln

Die REST-API, der MCP-Server und die CLI nutzen alle denselben API-Schlüssel und verwalten dieselben Links.

MCP-Server

Lassen Sie Ihren KI-Agenten die Links erstellen

Zum MCP-Server

Verkürzen Sie Ihren nächsten Link, ohne das Terminal zu verlassen

Installieren Sie die LinkTwin CLI und verwalten Sie Links direkt aus Ihrer Shell.

npm install -g @linktwin/cli

API-Zugriff gibt es in jedem Tarif. Tarife ansehen