Aller au contenu
Tous les articles

climcpapi

Un raccourcisseur d’URL en CLI pour les développeurs et les agents IA

Raccourcissez des URL en ligne de commande avec la CLI Linkdash : fichiers, extraits, tests A/B, ciblage des visiteurs et gestion par des agents IA via MCP.

Igor Kirnosov10 min de lecture

Un terminal crée un lien court Linkdash avec la commande linkdash links create

Linkdash est un raccourcisseur d’URL que vous pilotez depuis le terminal. Une seule commande transforme une URL, un fichier ou un extrait de texte en lien court suivi sur lida.sh, et affiche le résultat en JSON que vous pouvez rediriger vers n’importe quel outil. Les mêmes opérations sont disponibles via une API HTTP et sous forme de serveur MCP : un agent IA peut ainsi créer, modifier et mesurer des liens avec exactement les mêmes outils que vous.

Ce guide fait le tour complet de la CLI : l’installer, raccourcir votre premier lien, partager des fichiers, protéger des liens, lancer des tests A/B, router les visiteurs par pays ou par appareil, et lire les statistiques sans ouvrir de navigateur.

Le tableau de bord Linkdash liste les liens courts avec leur type, leur slug, leur cible et leur statut

Installer la CLI Linkdash

La CLI est un package npm et nécessite Node.js 20 ou une version ultérieure.

npm i -g linkdash-cli

Elle fonctionne de la même façon avec pnpm add -g linkdash-cli ou bun add -g linkdash-cli. La commande installée s’appelle linkdash.

Créez ensuite un compte et connectez la CLI, en une seule étape :

linkdash auth create

Cette commande ouvre la page d’inscription dans votre navigateur. Une fois votre compte créé, vous approuvez le code affiché dans votre terminal et la CLI est connectée. Si vous avez déjà un compte, utilisez plutôt linkdash auth login. linkdash auth whoami confirme le compte utilisé, et la référence de la CLI liste toutes les commandes et options.

La session est enregistrée dans ~/.config/linkdash/config.json, avec des permissions réservées au propriétaire. Pour la CI ou d’autres environnements sans interface, définissez LINKDASH_TOKEN avec le jeton de session de ce fichier, récupéré sur une machine où vous êtes connecté, et traitez-le comme n’importe quel autre secret.

Raccourcir une URL en ligne de commande

linkdash links create --url https://example.com/pricing --slug pricing
{
  "id": "pricing",
  "url": "https://lida.sh/pricing",
  "kind": "url",
  "variants": [
    { "name": "main", "kind": "url" }
  ]
}

C’est toute l’interface : les commandes réussies affichent du JSON sur stdout, et les erreurs affichent du texte brut sur stderr avec le code de sortie 1. Il n’y a pas d’option --json, car le JSON est le seul format de sortie. La CLI est donc facile à scripter. Pour copier directement un nouveau lien court dans votre presse-papiers sur macOS :

linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy

Quelques options que vous utiliserez en permanence :

  • --slug définit le chemin public. Les slugs utilisent des lettres minuscules, des chiffres et des tirets internes, jusqu’à 64 caractères. Sans cette option, Linkdash en génère un.
  • --name est un libellé privé, visible par vous seul, pratique pour retrouver vos liens plus tard.
  • --tag peut être répété : --tag launch --tag q4 ajoute deux tags à un lien.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term et --utm-content ajoutent des paramètres de campagne à la destination.

Listez et recherchez vos liens avec linkdash links list --q pricing --tag launch.

Partager un fichier ou un extrait de texte

Les liens courts ne servent pas qu’aux URL. La même commande envoie un fichier ou enregistre un extrait :

linkdash links create --file ./board-deck.pdf --slug board-deck --expires 7d
linkdash links create --text "Release checklist: tag, build, smoke test, announce" --tag launch

Un lien vers un fichier propose un téléchargement aux visiteurs, avec un aperçu pour les images et les vidéos. Un lien vers un texte affiche l’extrait sur une page avec un bouton de copie. Les deux sont suivis comme n’importe quel autre lien : vous voyez qui a ouvert votre présentation, et quand. Pour remplacer le fichier d’un lien existant sans changer l’URL :

linkdash links update board-deck --file ./board-deck-v2.pdf

Contrôler qui peut ouvrir un lien

Chaque lien peut avoir ses propres règles d’accès :

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • --password demande un mot de passe aux visiteurs avant d’ouvrir le lien.
  • --starts et --expires acceptent une durée comme 30m, 24h ou 7d, ou une date ISO. Avant sa date de début, un lien ne répond pas du tout.
  • --max-openings met le lien en pause après ce nombre d’ouvertures, ce qui est utile pour les téléchargements à usage unique.

Vous pouvez mettre en pause et réactiver un lien à tout moment avec linkdash links update q4-deck --status paused et --status active.

Faire un test A/B sur un lien court

Dans Linkdash, chaque lien est un conteneur d’une ou plusieurs variantes. Une variante est une destination (une URL, un fichier ou un texte) avec son propre poids et ses propres règles. Un lien normal a une seule variante, nommée main. Ajoutez-en d’autres, et le lien court répartit son trafic entre elles :

linkdash links create --slug launch \
  --variant control --url https://example.com/pricing \
  --variant annual-first --url "https://example.com/pricing?view=annual"

Les options qui suivent chaque --variant s’appliquent à cette variante jusqu’à la suivante. Le trafic est réparti selon le poids, qui vaut 1 par défaut : l’exemple ci-dessus est donc un test 50/50. Donnez --weight 3 à une variante pour lui envoyer trois fois plus de trafic.

L’attribution est persistante par défaut : un visiteur qui revient reçoit toujours la même variante, ce qui est indispensable pour un test équitable. Quand vous modifiez l’expérience, linkdash links update launch --restart-split redistribue tout le monde une fois.

Un lien Linkdash avec deux variantes, control et annual-first, qui répartit le trafic entre deux pages de tarifs

Les statistiques sont détaillées par variante, ce qui permet de les comparer directement :

linkdash links stats launch --last 7d

Le tableau variants de la sortie indique visits, visitors, downloads et plays pour chaque variante. Plus de détails sur les statistiques plus bas.

Router les visiteurs par pays, appareil ou paramètre de requête

Les variantes peuvent aussi avoir des conditions. Ajoutez --when à une variante, et seuls les visiteurs correspondants peuvent la recevoir. Un lien court devient alors un routeur. Par exemple, un seul lien qui envoie les téléphones vers le bon store :

linkdash links create --slug get-app \
  --variant ios \
    --url https://apps.apple.com/app/example/id000000000 \
    --when os=ios \
  --variant android \
    --url "https://play.google.com/store/apps/details?id=com.example" \
    --when os=android \
  --variant web \
    --url https://example.com/app

Quand un visiteur ouvre le lien, les variantes dont les conditions correspondent forment le pool de tirage. Si aucune ne correspond, ce sont les variantes sans condition qui sont utilisées : web ci-dessus récupère donc tous ceux qui ne sont ni sur iOS ni sur Android.

Un lien Linkdash qui envoie les visiteurs vers l’App Store sur iOS, vers Google Play sur Android et vers une page web pour tous les autres

Vous pouvez cibler selon :

Clé Correspond à Exemple
country Codes pays ISO --when country=DE,AT,CH
device mobile, tablet, desktop --when device=mobile
os windows, macos, android, ios, linux, other --when os=ios
browser edge, chrome, firefox, safari, other --when browser=safari
language Tags de langue, par préfixe --when language=de
referrer L’hôte référent --when referrer=twitter.com

Répétez --when pour exiger plusieurs conditions à la fois. --when country=DE,AT --when device=mobile cible les visiteurs sur mobile en Allemagne ou en Autriche.

Les variantes peuvent aussi cibler la query string du visiteur : un même lien peut ainsi se comporter différemment selon l’endroit où vous l’avez partagé. lida.sh/launch?src=newsletter peut envoyer les lecteurs de la newsletter vers une page dédiée :

linkdash links variants add launch --name newsletter \
  --url https://example.com/pricing/newsletter \
  --when param:src=newsletter

Les règles de paramètre prennent en charge égal à (=), différent de (!=), contient (~=), commence par (^=), se termine par ($=), fait partie de (=a|b), présent (param:ref?) et absent (param:!ref). Si vous préférez transmettre les paramètres du visiteur à la destination, créez le lien avec --forward-params.

Le tableau de bord propose les mêmes réglages, avec un sélecteur de pays qui cherche par nom : inutile de vous souvenir que la Slovénie, c’est SI.

Sélection des pays ciblés pour une variante dans le tableau de bord Linkdash, avec l’Allemagne et l’Autriche sélectionnées

Lire les statistiques de clics depuis le terminal

linkdash links stats launch --last 7d

La sortie inclut le total des visits, downloads et plays, le nombre de visites sur la période demandée (visitsInLast), les countries et referrers d’où viennent ces visites, une ventilation variants, et une liste visitors avec l’heure, le pays, l’appareil, le navigateur et le référent de chaque visite récente. --last accepte une durée comme 24h ou 30d, et vaut 24h par défaut.

Linkdash ne stocke pas les adresses IP des visiteurs. L’adresse sert à déterminer le pays du visiteur et à calculer un identifiant de visiteur anonyme qui change chaque jour, puis elle est supprimée.

Pour réagir aux clics en temps réel, enregistrez un webhook. Linkdash envoie des événements signés link.visit, link.download et link.play à n’importe quel endpoint HTTPS :

linkdash webhooks create --url https://example.com/hooks

Le secret de signature n’est affiché qu’une fois : enregistrez-le tout de suite. Consultez la documentation des webhooks pour vérifier les signatures.

Laisser des agents IA créer des liens courts avec MCP

Tout ce qui précède est aussi accessible aux agents IA. Linkdash fait tourner un serveur MCP distant sur https://api.linkdash.dev/mcp, dont les outils reprennent ceux de la CLI : links_create, links_update, links_stats, variants_add, domains_add, etc., et renvoient le même JSON.

Créez une clé API dans le tableau de bord, sous Clés API, puis connectez votre agent. Dans Claude Code :

claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
  --header "Authorization: Bearer $LINKDASH_API_KEY"

Dans Cursor, ajoutez-le à .cursor/mcp.json :

{
  "mcpServers": {
    "linkdash": {
      "url": "https://api.linkdash.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
    }
  }
}

Dans Codex, qui lit la clé dans la variable d’environnement que vous indiquez :

codex mcp add linkdash --url https://api.linkdash.dev/mcp \
  --bearer-token-env-var LINKDASH_API_KEY

Vous pouvez ensuite demander des liens en langage naturel, par exemple « raccourcis https://example.com/pricing en pricing et ajoute le tag launch » ou « quelle variante de launch a eu le plus de visiteurs cette semaine ? », et l’agent appelle le bon outil. La documentation MCP couvre aussi OpenCode.

Si votre agent travaille déjà dans un terminal, il peut utiliser directement la CLI. Installez la skill d’agent Linkdash pour qu’il connaisse les commandes et les options :

npx skills add https://linkdash.dev/skills/linkdash/SKILL.md

Utiliser l’API HTTP

Pour votre propre code, les mêmes opérations sont exposées par une API REST classique sur https://api.linkdash.dev/v1, authentifiée avec la même clé API :

curl https://api.linkdash.dev/v1/links \
  -H "Authorization: Bearer $LINKDASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/pricing", "slug": "pricing" }'

La réponse a la même forme que la sortie de la CLI. La référence de l’API couvre tous les endpoints, y compris l’envoi de fichiers et les variantes.

Utiliser votre propre domaine

Par défaut, les liens courts sont servis sur lida.sh. Pour les servir depuis votre propre domaine, ajoutez-le et faites pointer votre DNS vers Linkdash :

linkdash domains add go.example.com
linkdash domains verify go.example.com

Créez ensuite des liens dessus avec --domain go.example.com. Chaque domaine personnalisé a son propre ensemble de slugs : go.example.com/launch n’entre donc pas en conflit avec le launch de quelqu’un d’autre. Le guide des domaines détaille la configuration DNS, y compris la configuration en un clic chez les fournisseurs qui la prennent en charge.

Tarifs

L’offre Free ne demande pas de carte bancaire et inclut 5 000 événements par mois, 1 Go de stockage de fichiers, un mois d’historique de statistiques et un domaine personnalisé. Un événement correspond à une visite, un téléchargement ou une lecture sur l’un de vos liens, ou à une écriture comme la création ou la modification d’un lien. Les lectures, comme lister les liens ou récupérer les statistiques, sont gratuites.

Les offres payantes relèvent ces limites : Professional coûte 18 $ par mois et Growth 48 $ par mois. Consultez les tarifs pour la comparaison complète.

FAQ

Existe-t-il un raccourcisseur d’URL gratuit avec une CLI ?

Oui. La CLI Linkdash fonctionne avec l’offre Free, qui inclut 5 000 événements par mois, sans carte bancaire.

Puis-je utiliser la CLI Linkdash en CI ?

Oui. Définissez LINKDASH_TOKEN avec un jeton de session, et la CLI fonctionne sans navigateur. Comme chaque commande affiche du JSON, vous pouvez créer et modifier des liens depuis GitHub Actions ou n’importe quel autre pipeline, et lire les résultats avec jq.

Les agents IA peuvent-ils créer des liens courts ?

Oui, de trois façons : via le serveur MCP sur https://api.linkdash.dev/mcp, via la CLI avec la skill d’agent Linkdash installée, ou via l’API HTTP. Les trois exposent les mêmes opérations et renvoient le même JSON.

Linkdash stocke-t-il les adresses IP des visiteurs ?

Non. Linkdash utilise l’adresse pour déterminer le pays du visiteur et créer un identifiant anonyme quotidien, puis la supprime. Les propriétaires des liens ne voient jamais les adresses IP.

Un même lien court peut-il envoyer des visiteurs différents vers des pages différentes ?

Oui. Donnez plusieurs variantes à un lien, et ajoutez à chacune des conditions comme le pays, l’appareil, le système d’exploitation, la langue, le référent ou un paramètre de requête. Sans condition, les variantes se répartissent le trafic selon leur poids : c’est ainsi que vous faites un test A/B.


Prêt à essayer ? Installez la CLI, lancez linkdash auth create et raccourcissez votre premier lien en moins d’une minute. Le guide de démarrage rapide détaille chaque étape.