npm i -g @linktwin/cli

CLI LinkTwin : raccourcissez et gérez vos liens en ligne de commande.

Le CLI LinkTwin amène les liens courts et les deep links dans votre terminal. Créez, modifiez et analysez vos liens, gérez QR codes, collections, domaines et pixels, et automatisez le tout avec des commandes simples et une sortie JSON. Conçu pour les développeurs, les scripts et la CI.

npm install -g @linktwin/cli
Voir toutes les commandes
  • Node.js 18 ou plus récent
  • Sous licence MIT, sur npm
  • Scriptable avec --json
maya@studio: ~/links

Exemple de session avec de vraies commandes et formats de sortie.

Conçu pour les développeurs

Arrêtez de changer de contexte pour raccourcir un lien.

Vous vivez dans le terminal. Ouvrir un tableau de bord pour créer un lien, ou bricoler des appels API pour un script rapide, vous ralentit. Le CLI LinkTwin met la création de liens, le deep linking et les analyses à une commande de distance.

Étapes pour y arriver

  • Tableau de bord
  • CLI LinkTwin
Raccourcir un lien avec un alias
Lister vos liens les plus cliqués
Compté pour une personne déjà connectée, avec un terminal ouvert. Chaque bloc correspond à une action.
La tâche L'ancienne méthode Avec le CLI LinkTwin
Créer un lien Quitter le terminal pour le tableau de bord linktwin links create <url>
Connexion Écrire curl + authentification pour chaque script Une seule connexion, puis rien que des commandes
Traitement en masse Pas d'opérations en masse simples Créez et supprimez en masse en toute simplicité
Automatisation Difficile à intégrer à la CI --json + variable d'environnement = prêt pour la CI

Commencer

Opérationnel en deux commandes

Nécessite Node.js 18+. Votre clé API est enregistrée localement dans ~/.linktwin/config.json.

Terminal 
# 1. Installer (Node.js 18 ou plus récent)
npm install -g @linktwin/cli

# 2. S'authentifier (collez votre clé API)
linktwin login

# 3. Créer votre premier lien
linktwin links create https://example.com --custom hello

Vous utilisez l'IA ? Essayez le serveur MCP. Vous écrivez votre propre intégration ? Lisez la documentation de l'API.

D'où vient votre clé API

Le CLI cherche les identifiants dans cet ordre et utilise le premier trouvé : une tâche de CI peut donc remplacer votre connexion enregistrée sans y toucher.

  1. Options--api-key --base-url
  2. Variables d'environnementLINKTWIN_API_KEY LINKTWIN_BASE_URL
  3. Connexion enregistrée~/.linktwin/config.json, écrit par linktwin login et lisible uniquement par vous (mode 0600).
  4. URL de base par défauthttps://linktw.in

Commandes

Tout, depuis une seule commande

Une commande dédiée pour chaque étape de votre flux de travail sur les liens. Chaque commande accepte aussi les options globales --json, --api-key, --base-url.

linktwin stats

Analyses par lien et au niveau du compte : clics, pays, référents, appareils et tendances.

  • linktwin stats link <id>

    Analyses d'un seul lien (ID ou URL courte)

    • --timezone
  • linktwin stats dashboard

    KPI agrégés du compte et tendance des clics

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

    Analyses détaillées du compte avec répartitions

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

    Répartition des clics par heure/jour (tendance du jour)

    • -p, --period
    • --timezone
Exemple de sortie 
$ 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

Organisez vos liens en collections et attribuez-les en masse.

  • linktwin collections list

    Lister les collections

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

    Lister les éléments d'une collection

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

    Créez une collection

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

    Mettre à jour une collection

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

    Ajouter/retirer des liens dans une collection (ID de liens séparés par des virgules)

    • --remove
  • linktwin collections delete <id>

    Supprimer une collection (les éléments sont retirés, pas supprimés)

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

linktwin domains

Ajoutez et gérez vos domaines personnalisés de marque.

  • linktwin domains list

    Lister tous les domaines disponibles (standard + de marque)

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

    Ajouter un domaine de marque (incluez http:// ou https://)

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

    Mettre à jour un domaine de marque

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

    Supprimer un domaine de marque

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

linktwin pixels

Créez des pixels de reciblage et attachez-les à vos liens.

  • linktwin pixels list

    Lister les pixels de retargeting

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

    Afficher un pixel et ses liens associés

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

    Créer un pixel de retargeting

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

    Mettre à jour un pixel

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

    Ajouter/retirer un pixel sur des liens (ID de liens séparés par des virgules)

    • --remove
  • linktwin pixels delete <id>

    Supprimer un pixel

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

linktwin qr

Générez et gérez des codes QR pour n'importe quel lien.

  • linktwin qr list

    Lister les codes QR

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

    Afficher un QR code et ses analyses de scans

  • linktwin qr create

    Créer un QR code

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

    Mettre à jour un QR code

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

    Supprimer un QR code

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

Compte

Enregistrez votre clé une fois, vérifiez quel compte vous utilisez et voyez d'où viennent vos identifiants.

  • linktwin login

    Enregistrer votre clé API LinkTwin et l'URL de base

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

    Supprimer les identifiants enregistrés

  • linktwin whoami

    Afficher le compte, le plan et l'utilisation actuels

  • linktwin config

    Afficher d'où les identifiants sont lus

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

Conçu pour les scripts, les tâches cron et la CI.

Les mêmes commandes fonctionnent dans un script shell, une tâche planifiée ou un pipeline de build. Ajoutez --json pour une sortie exploitable, et passez votre clé en variable d'environnement.

  • --json sur n'importe quelle commande affiche la réponse brute de l'API, prête pour jq.
  • LINKTWIN_API_KEY et LINKTWIN_BASE_URL remplacent la connexion enregistrée : la CI n'a donc jamais besoin de linktwin login.
  • Les commandes de suppression refusent de s'exécuter sans --yes : un script ne supprime donc jamais de liens par accident.
  • Toute erreur se termine avec le code 1 et affiche la raison sur stderr : une étape en échec arrête donc votre pipeline.
jq 
# Vos 5 liens les plus cliqués, avec clics et URL courte
linktwin links list --order clicks_desc --limit 5 --json \
  | jq -r '.data.urls[] | "\(.clicks)\t\(.shorturl)"'
Création en masse 
# Un lien court pour chaque URL de urls.txt
while read -r url; do
  linktwin links create "$url" --json | jq -r '.shorturl'
done < urls.txt
Ciblage 
# Ciblage géographique et paramètres UTM, passés en 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 
# Une étape de workflow : un lien court pour chaque 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

Questions sur le CLI

Tout sur l'outil en ligne de commande LinkTwin. D'autres questions ? Contactez-nous.

Qu'est-ce que le CLI LinkTwin ?

Le CLI LinkTwin est un outil en ligne de commande, la commande linktwin, pour raccourcir et gérer vos liens depuis votre terminal. Vous pouvez créer des liens courts et des deep links, gérer collections, domaines de marque, pixels de retargeting et QR codes, et récupérer les analyses des clics sans ouvrir le tableau de bord. Chaque commande prend en charge la sortie --json pour les scripts et l'automatisation.

Comment installer le CLI LinkTwin ?

Installez-le depuis npm avec npm install -g @linktwin/cli. Il nécessite Node.js 18 ou plus récent. Exécutez ensuite linktwin login, collez votre clé API, et vous êtes prêt à créer des liens depuis la ligne de commande.

Le CLI du raccourcisseur d'URL est-il gratuit ?

Le CLI lui-même est gratuit et sous licence MIT. Il fonctionne via l'API LinkTwin, et l'accès à l'API est disponible avec tous les plans. Vous pouvez d'abord créer un compte gratuit et passer à un plan supérieur quand vous avez besoin de l'API.

Puis-je utiliser le CLI dans des scripts et la CI ?

Oui. Ajoutez --json à n'importe quelle commande pour une sortie lisible par machine que vous pouvez envoyer à jq, et authentifiez-vous sans invite en définissant la variable d'environnement LINKTWIN_API_KEY. Le CLI est donc idéal pour les pipelines de build, les tâches cron et la création de liens en masse.

Le CLI peut-il créer des deep links, et pas seulement des liens courts ?

Oui. Chaque lien que vous créez s'ouvre dans la bonne app sur téléphone, comme YouTube, Amazon ou Spotify. Le CLI gère aussi le ciblage par pays, appareil et langue, les tests A/B, les paramètres UTM et les domaines de marque. Passez le ciblage avancé en JSON avec l'option --data.

Où puis-je obtenir ma clé API ?

Connectez-vous à LinkTwin et ouvrez Paramètres, ou Outils & Intégrations puis Outil CLI, dans votre tableau de bord. Copiez votre clé API et exécutez linktwin login, ou définissez-la comme variable d'environnement LINKTWIN_API_KEY. La clé s'affiche dès que votre plan inclut l'accès à l'API.

Quelles commandes propose le CLI LinkTwin ?

login, logout, whoami et config pour vos identifiants, plus six groupes de commandes : links, stats, collections, domains, pixels et qr. Lancez linktwin suivi de n'importe quelle commande et de --help pour voir toutes ses options.

Comment désigner un lien dans une commande ?

Utilisez son ID numérique ou son URL courte, par exemple linktwin stats link linktw.in/desk-tour. L'URL courte fonctionne avec ou sans https://. Vous trouverez les deux dans la sortie de linktwin links list.

Une clé API, trois façons de développer

L'API REST, le serveur MCP et la CLI utilisent tous la même clé API et gèrent les mêmes liens.

Raccourcissez votre prochain lien sans quitter le terminal

Installez le CLI LinkTwin et gérez vos liens depuis votre shell.

npm install -g @linktwin/cli

L'accès à l'API est disponible avec tous les plans. Voir les plans