Linkly CLI
La CLI Linkly est un outil de ligne de commande pour gérer votre compte Linkly depuis le terminal. Créez des liens courts, extrayez les analyses de clics, gérez les domaines personnalisés, gérez les webhooks et exportez des données — sans quitter votre shell ni écrire de code API.
Elle est construite sur l'API Linkly et s'exécute sur macOS, Linux et Windows.
Installation
La CLI nécessite Node.js version 20 ou plus récente. 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
Connexion
La CLI supporte deux façons de se connecter. Vous ne devez faire cela qu'une seule 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 "Spring promo"
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
Afficher 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 clics en temps réel pour un seul lien ou un espace de travail entier :
linkly webhooks add https://example.com/hook --link 12345
Travailler avec plusieurs espaces de travail
Si votre compte dispose de plus d'un espace de travail, définissez un par 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é — pratique pour canaliser vers des outils comme jq :
linkly links list --json
Obtenir de l'aide
Chaque commande dispose d'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 directement la CLI Linkly.
- Ajoutez
--jsonà n'importe quelle commande pour obtenir la réponse API brute au lieu d'un tableau formaté. - Exécutez
linkly schemapour 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 plutôt le serveur Linkly MCP — il connecte des assistants comme Claude et ChatGPT à votre compte Linkly directement.
Articles connexes
Obtenez 100 liens courts et suivez 500 clics mensuels gratuitement.