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 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 plutôt le serveur Linkly MCP — il connecte des assistants comme Claude et ChatGPT à votre compte Linkly directement.

Articles connexes

Linkly CLI logo
Linkly CLI logo

Obtenez 100 liens courts et suivez 500 clics mensuels gratuitement.