npm i -g @linktwin/cli

LinkTwin CLI: abbrevia e gestisci i link dalla riga di comando.

La LinkTwin CLI porta link brevi e deep link nel tuo terminale. Crea, modifica e analizza link, gestisci codici QR, collezioni, domini e pixel, e automatizza tutto con comandi semplici e output JSON. Pensata per sviluppatori, script e CI.

npm install -g @linktwin/cli
Vedi tutti i comandi
  • Node.js 18 o successivo
  • Licenza MIT, su npm
  • Programmabile con --json
maya@studio: ~/links

Sessione di esempio con comandi reali e formati di output.

Pensato per gli sviluppatori

Smetti di cambiare contesto per abbreviare un link.

Vivi nel terminale. Aprire una dashboard per creare un link, o scrivere a mano le chiamate API per uno script veloce, ti rallenta. La CLI di LinkTwin mette la creazione dei link, il deep linking e le analytics a un solo comando di distanza.

Passaggi per completarlo

  • Dashboard
  • LinkTwin CLI
Abbrevia un link con un alias
Elenca i tuoi link più cliccati
Conteggio per chi ha già effettuato l'accesso e ha un terminale aperto. Ogni blocco è un'azione.
L'attività Il vecchio metodo Con la CLI di LinkTwin
Creare un link Lasciare il terminale per la dashboard linktwin links create <url>
Accesso Scrivere curl + autenticazione per ogni script Un solo login, poi solo comandi
Operazioni in blocco Nessuna operazione in blocco semplice Crea ed elimina in blocco con facilità
Automazione Difficile da integrare nella CI --json + variabile d'ambiente = pronto per la CI

Inizia

Operativo in due comandi

Richiede Node.js 18+. La tua API key viene salvata localmente in ~/.linktwin/config.json.

Terminale 
# 1. Installa (Node.js 18 o successivo)
npm install -g @linktwin/cli

# 2. Autenticati (incolla la tua chiave API)
linktwin login

# 3. Crea il tuo primo link
linktwin links create https://example.com --custom hello

Usi l'AI? Prova il server MCP. Stai scrivendo la tua integrazione? Leggi la documentazione API.

Da dove arriva la tua chiave API

La CLI cerca le credenziali in quest'ordine e usa le prime che trova, così un job di CI può sovrascrivere il tuo login salvato senza toccarlo.

  1. Flag--api-key --base-url
  2. Variabili d'ambienteLINKTWIN_API_KEY LINKTWIN_BASE_URL
  3. Login salvato~/.linktwin/config.json, scritto da linktwin login e leggibile solo da te (modalità 0600).
  4. URL di base predefinitohttps://linktw.in

Comandi

Tutto, da un unico comando

Un comando dedicato per ogni parte del tuo flusso di lavoro sui link. Ogni comando accetta anche le opzioni globali --json, --api-key, --base-url.

linktwin stats

Analytics per singolo link e per l'intero account: click, paesi, referrer, dispositivi e tendenze.

  • linktwin stats link <id>

    Analytics per un singolo link (id o URL breve)

    • --timezone
  • linktwin stats dashboard

    KPI aggregati dell'account e andamento dei clic

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

    Analytics dettagliate dell'account con suddivisioni

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

    Distribuzione oraria/giornaliera dei clic (andamento del giorno)

    • -p, --period
    • --timezone
Output di esempio 
$ 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

Organizza i link in collezioni e assegna i link in blocco.

  • linktwin collections list

    Elenca le collezioni

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

    Elenca gli elementi di una collezione

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

    Crea una raccolta

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

    Aggiorna una collezione

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

    Aggiungi/rimuovi link in una collezione (ID dei link separati da virgola)

    • --remove
  • linktwin collections delete <id>

    Elimina una collezione (gli elementi vengono scollegati, non eliminati)

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

linktwin domains

Aggiungi e gestisci i tuoi domini personalizzati con brand.

  • linktwin domains list

    Elenca tutti i domini disponibili (standard + personalizzati)

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

    Aggiungi un dominio personalizzato (includi http:// o https://)

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

    Aggiorna un dominio personalizzato

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

    Elimina un dominio personalizzato

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

linktwin pixels

Crea pixel di retargeting e allegali ai link.

  • linktwin pixels list

    Elenca i pixel di retargeting

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

    Mostra un pixel e i link a cui è assegnato

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

    Crea un pixel di retargeting

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

    Aggiorna un pixel

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

    Aggiungi/rimuovi un pixel sui link (ID dei link separati da virgola)

    • --remove
  • linktwin pixels delete <id>

    Elimina un pixel

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

linktwin qr

Genera e gestisci codici QR per qualsiasi link.

  • linktwin qr list

    Elenca Codici QR

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

    Mostra un codice QR e le sue statistiche di scansione

  • linktwin qr create

    Crea un codice QR

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

    Aggiorna un codice QR

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

    Elimina un codice QR

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

Account

Salva la tua chiave una volta, controlla quale account stai usando e vedi da dove arrivano le tue credenziali.

  • linktwin login

    Salva la tua chiave API di LinkTwin e l'URL di base

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

    Rimuovi le credenziali salvate

  • linktwin whoami

    Mostra l'account corrente, il piano e l'utilizzo

  • linktwin config

    Mostra da dove vengono lette le credenziali

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

Pensata per script, cron job e CI.

Gli stessi comandi funzionano in uno script shell, in un job pianificato o in una pipeline di build. Aggiungi --json per un output che puoi analizzare e passa la tua chiave come variabile d'ambiente.

  • --json su qualsiasi comando stampa la risposta grezza dell'API, pronta per jq.
  • LINKTWIN_API_KEY e LINKTWIN_BASE_URL hanno la precedenza sul login salvato, così la CI non ha mai bisogno di linktwin login.
  • I comandi di eliminazione non partono senza --yes, così uno script non rimuove mai link per errore.
  • Qualsiasi errore termina con codice 1 e stampa il motivo su stderr, così uno step che fallisce ferma la tua pipeline.
jq 
# I tuoi 5 link più cliccati, con clic e URL breve
linktwin links list --order clicks_desc --limit 5 --json \
  | jq -r '.data.urls[] | "\(.clicks)\t\(.shorturl)"'
Creazione in blocco 
# Un link breve per ogni URL in urls.txt
while read -r url; do
  linktwin links create "$url" --json | jq -r '.shorturl'
done < urls.txt
Targeting 
# Geo-targeting e parametri UTM, passati come JSON
linktwin links create https://example.com --custom promo \
  --data '{"geotarget":[{"location":"Canada","link":"https://example.ca"}],
           "parameters":[{"name":"utm_source","value":"newsletter"}]}'
GitHub Actions 
# Uno step del workflow: un link breve per ogni 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

Domande sulla CLI

Tutto sullo strumento a riga di comando di LinkTwin. Hai ancora domande? Contattaci.

Che cos'è la CLI di LinkTwin?

La LinkTwin CLI è uno strumento a riga di comando, il comando linktwin, per abbreviare e gestire i link dal terminale. Puoi creare link brevi e deep link, gestire collezioni, domini personalizzati, pixel di retargeting e codici QR, e ottenere le analisi dei clic senza aprire la dashboard. Ogni comando supporta l'output --json per script e automazioni.

Come installo la CLI di LinkTwin?

Installala da npm con npm install -g @linktwin/cli. Richiede Node.js 18 o successivo. Poi esegui linktwin login, incolla la tua chiave API e sei pronto a creare link dalla riga di comando.

La CLI dell'accorciatore di URL è gratuita?

La CLI in sé è gratuita e con licenza MIT. Funziona tramite l'API di LinkTwin, e l'accesso API è disponibile con tutti i piani. Puoi creare prima un account gratuito e fare l'upgrade quando ti serve l'API.

Posso usare la CLI in script e CI?

Sì. Aggiungi --json a qualsiasi comando per un output leggibile dalle macchine da passare a jq, e autenticati senza prompt impostando la variabile d'ambiente LINKTWIN_API_KEY. Questo rende la CLI ideale per pipeline di build, cron job e creazione di link in blocco.

La CLI può creare deep link, non solo short link?

Sì. Ogni link che crei si apre nell'app giusta su un telefono, come YouTube, Amazon o Spotify. La CLI imposta anche il targeting per area geografica, dispositivo e lingua, i test A/B, i parametri UTM e i domini personalizzati. Passa il targeting avanzato come JSON con il flag --data.

Dove ottengo la mia API key?

Accedi a LinkTwin e apri Impostazioni, oppure Strumenti e integrazioni e poi Strumento CLI, nella tua dashboard. Copia la tua chiave API ed esegui linktwin login, oppure impostala come variabile d'ambiente LINKTWIN_API_KEY. La chiave viene mostrata quando il tuo piano include l'accesso API.

Quali comandi ha la LinkTwin CLI?

login, logout, whoami e config per le tue credenziali, più sei gruppi di comandi: links, stats, collections, domains, pixels e qr. Esegui linktwin seguito da qualsiasi comando e --help per vedere tutte le sue opzioni.

Come faccio riferimento a un link in un comando?

Usa il suo ID numerico o il suo URL breve, per esempio linktwin stats link linktw.in/desk-tour. L'URL breve funziona con o senza https://. Li trovi entrambi nell'output di linktwin links list.

Una chiave API, tre modi per sviluppare

L'API REST, il server MCP e la CLI usano tutti la stessa chiave API e gestiscono gli stessi link.

Accorcia il tuo prossimo link senza uscire dal terminale

Installa la CLI di LinkTwin e inizia a gestire i link dalla tua shell.

npm install -g @linktwin/cli

L'accesso API è disponibile con tutti i piani. Vedi i piani