Linkly CLI

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 alcun codice API.

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

Installazione

La CLI richiede Node.js 20 o più recente. 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 accedere. Devi farlo solo una 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, esegui:

linkly auth login

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

Controlla il tuo stato o esci 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 — o 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 aggiungine uno nuovo:

linkly domains list

linkly domains create links.example.com

Codici QR ed esportazioni di dati

Scarica il codice QR di un link, o 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

Lavoro con più workspace

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

linkly workspaces list

linkly workspaces use 42

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

Output JSON per gli script

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

linkly links list --json

Ottenere aiuto

Ogni comando ha una guida integrata. Esegui linkly --help per una panoramica, o aggiungi --help a qualsiasi comando per visualizzare le sue opzioni ed esempi:

linkly links create --help

Utilizzo della CLI con agenti AI

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

• Aggiungi --json a qualsiasi comando per ottenere la risposta API grezza anziché una tabella formattata.
• Esegui linkly schema per stampare l'intero albero dei 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 visualizzare le sue opzioni ed esempi.

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