Linkly CLI

La Linkly CLI est un outil en ligne de commande pour gérer votre compte Linkly depuis le terminal. Créez des liens courts, récupérez les analyses de clics, gérez les domaines personnalisés, gérez les webhooks et exportez les données — sans quitter votre shell ou écrire du code API.

Elle est construite sur l'API Linkly et fonctionne sur macOS, Linux et Windows.

Installation

La CLI nécessite Node.js 20 ou plus récent. Installez-la globalement avec npm :

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

Cela ajoute une commande linkly à votre système. Confirmez qu'elle fonctionne :

linkly --help

Se connecter

La CLI supporte deux façons de se connecter. Vous ne devez le faire qu'une fois — vos identifiants sont sauvegardés de manière sécurisée sur votre machine et réutilisés à chaque exécution.

Pour vous connecter avec une clé API, exécutez :

linkly auth login --api-key

Vous serez invité à coller votre clé API, que vous pouvez trouver dans les paramètres de votre compte Linkly.

Pour vous connecter avec OAuth à la place, exécutez :

linkly auth login

Cela ouvre votre navigateur pour que vous puissiez approuver l'accès — il n'y a pas de clé API à copier.

Vérifiez votre statut ou déconnectez-vous à tout moment :

linkly auth status

linkly auth logout

Créer et gérer des liens

Créez, recherchez, inspectez, mettez à jour et supprimez des liens courts :

linkly links create --url https://example.com --name "Promo printemps"

linkly links list --search promo

linkly links get 12345

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

linkly links delete 12345

Analyses de clics

Consultez les totaux de clics regroupés par pays, navigateur, plateforme, etc. — ou sous forme de série temporelle sur une plage de dates :

linkly analytics by country

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

Domaines personnalisés

Listez vos domaines personnalisés ou ajoutez-en un nouveau :

linkly domains list

linkly domains create links.example.com

Codes QR et exports de données

Téléchargez le code QR d'un lien, ou exportez vos liens et données de clics en CSV ou JSON :

linkly links qr 12345 --output qr.png

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

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

Webhooks

Abonnez une URL pour recevoir les événements de clic en temps réel pour un lien unique ou un espace de travail entier :

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

Travailler avec plusieurs espaces de travail

Si votre compte a plus d'un espace de travail, définissez un défaut :

linkly workspaces list

linkly workspaces use 42

Vous pouvez également cibler un espace de travail spécifique pour une seule commande avec l'option --workspace.

Sortie JSON pour les scripts

Ajoutez --json à n'importe quelle commande pour obtenir la réponse API brute au lieu d'un tableau formaté — utile pour canaliser vers des outils comme jq :

linkly links list --json

Obtenir de l'aide

Chaque commande a une aide intégrée. Exécutez linkly --help pour un aperçu, ou ajoutez --help à n'importe quelle commande pour voir ses options et exemples :

linkly links create --help

Utiliser la CLI avec des agents IA

Les assistants de codage qui peuvent exécuter des commandes shell — comme Claude Code ou Cursor — peuvent piloter la Linkly CLI directement.

• Ajoutez --json à n'importe quelle commande pour obtenir la réponse API brute au lieu d'un tableau formaté.
• Exécutez linkly schema pour imprimer l'arborescence complète des commandes — chaque commande, argument et option — en JSON, afin qu'un assistant puisse découvrir ce que la CLI peut faire.
• Ajoutez --help à n'importe quelle commande pour voir ses options et exemples.

Si votre assistant IA ne peut pas exécuter de commandes shell, utilisez à la place le Serveur Linkly MCP — il connecte des assistants comme Claude et ChatGPT directement à votre compte Linkly.