Linkly CLI

Name: Linkly
Rating: 4.8 (38 reviews)
Author: Linkly

La Linkly CLI è uno strumento da riga di comando per gestire il tuo account Linkly dal terminale. Crea link brevi, estrai analitiche dei clic, gestisci domini personalizzati, gestisci webhook ed esporta dati — senza lasciare la tua shell o scrivere codice API.

È costruita sull'API di Linkly e funziona su macOS, Linux e Windows.

Installazione

La CLI richiede Node.js versione 20 o successiva. Installala globalmente con npm:


npm install -g @linkly-link-shortener/cli

Questo aggiunge un comando linkly al tuo sistema. Conferma che funziona:


linkly --help

Accesso

La CLI supporta due modi per effettuare l'accesso. Devi farlo una sola volta — le tue credenziali vengono salvate in modo sicuro sulla tua macchina e riutilizzate ad ogni esecuzione.

Per accedere con una chiave API, esegui:


linkly auth login --api-key

Ti verrà chiesto di incollare la tua chiave API, che puoi trovare nelle impostazioni del tuo account Linkly.

Per accedere con OAuth invece, esegui:


linkly auth login

Questo apre il tuo browser in modo che tu possa approvare l'accesso — non c'è alcuna chiave API da copiare.

Controlla il tuo stato o effettua il logout in qualsiasi momento:


linkly auth status

linkly auth logout

Creazione e gestione dei link

Crea, cerca, ispeziona, aggiorna ed elimina link brevi:


linkly links create --url https://example.com --name "Spring promo"

linkly links list --search promo

linkly links get 12345

linkly links update 12345 --url https://example.com/new

linkly links delete 12345

Analitiche dei clic

Visualizza i totali dei clic raggruppati per paese, browser, piattaforma e altro — oppure come una serie temporale su un intervallo di date:


linkly analytics by country

linkly analytics timeseries --start 2026-01-01 --end 2026-01-31

Domini personalizzati

Elenca i tuoi domini personalizzati o aggiungi uno nuovo:


linkly domains list

linkly domains create links.example.com

Codici QR ed esportazioni di dati

Scarica il codice QR di un link, oppure esporta i tuoi link e i dati dei clic come CSV o JSON:


linkly links qr 12345 --output qr.png

linkly links export --format csv --output links.csv

linkly analytics export --format csv --output clicks.csv

Webhook

Sottoscrivi un URL per ricevere eventi di clic in tempo reale per un singolo link o un intero workspace:


linkly webhooks add https://example.com/hook --link 12345

Lavorare con più workspace

Se il tuo account ha più di uno workspace, imposta uno predefinito:


linkly workspaces list

linkly workspaces use 42

Puoi anche specificare uno workspace specifico per un singolo comando con l'opzione --workspace.

Output JSON per script

Aggiungi --json a qualsiasi comando per ottenere la risposta API grezza invece di una tabella formattata — utile per il piping in strumenti come jq:


linkly links list --json

Ottenere aiuto

Ogni comando ha un aiuto integrato. Esegui linkly --help per una panoramica, oppure aggiungi --help a qualsiasi comando per vedere le sue opzioni ed esempi:


linkly links create --help

Utilizzo della CLI con agenti IA

Gli assistenti di codifica che possono eseguire comandi shell — come Claude Code o Cursor — possono controllare la Linkly CLI direttamente.

Aggiungi --json a qualsiasi comando per ottenere la risposta API grezza invece di una tabella formattata.
Esegui linkly schema per stampare l'intero albero di comandi — ogni comando, argomento e opzione — come JSON, in modo che un assistente possa scoprire cosa può fare la CLI.
Aggiungi --help a qualsiasi comando per vedere le sue opzioni ed esempi.

Se il tuo assistente IA non può eseguire comandi shell, utilizza il Server MCP di Linkly invece — connette assistenti come Claude e ChatGPT al tuo account Linkly direttamente.