Intégration Yourls n8nAutomatiser Yourls avec n8n.
Tes liens courts vivent sur ton serveur, et n8n sait les piloter. Le nœud Yourls expose 3 opérations sur une seule ressource, URL : raccourcir, déplier, lire les stats. Aucun nœud trigger n'existe, l'exécution démarre ailleurs. Cette intégration Yourls n8n vise les équipes qui gardent leurs liens chez elles.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration Yourls n8n ?
Yourls est un raccourcisseur de liens que tu installes sur ton propre serveur. Le nœud n8n dialogue avec cette instance via son API et transforme la gestion des liens en une étape de workflow : une adresse longue entre, un lien court sort, la suite du scénario continue. Le trajet inverse marche aussi, puisque le nœud sait retrouver la destination d'un lien court ou récupérer les statistiques que ton instance a gardées.
Une ressource, URL, et 3 opérations. Le nœud est volontairement court, parce que raccourcir un lien n'est presque jamais l'objectif d'un workflow : c'est une étape au milieu. Toute la profondeur vient de ce qu'on met autour.
Premier cas, la newsletter. Avant qu'un nœud Gmail parte, le workflow passe chaque lien dans url.shorten, avec le champ Keyword renseigné si besoin, dans Additional Fields. Les adresses envoyées sont propres, et elles pointent vers ton domaine à toi, pas vers celui d'un service tiers.
Deuxième cas, le partage interne. Un Webhook n8n reçoit une URL longue depuis un formulaire, le nœud la raccourcit, et le lien revient dans un canal Slack. Troisième cas, le reporting : un Schedule Trigger se déclenche chaque lundi, url.stats parcourt les liens de la semaine et écrit une ligne par lien dans Google Sheets. Le template public n8n 815 montre déjà l'enchaînement, création d'un lien court puis lecture de ses stats dans la même exécution.
Quand une action manque, le nœud HTTP Request prend le relais. Il appelle n'importe quel endpoint de l'API Yourls et réutilise le même credential grâce à l'authentification prédéfinie, donc pas de seconde connexion à créer. C'est la porte de sortie pour tout ce qui sort des 3 opérations, par exemple lister la totalité des liens de la base.
Deux limites à connaître avant de te lancer. Il n'y a pas de nœud trigger Yourls : rien ne réagit tout seul à un clic, le workflow doit être démarré par un Schedule Trigger, un Webhook n8n ou le trigger d'un autre outil. Et l'instance doit exister avant tout le reste, installée sur ton serveur, ce qui est exactement le compromis face à un raccourcisseur hébergé comme Bitly. Si tu veux prendre le sujet plus large, la Formation n8n reprend ces briques une par une.
Comment connecter n8n à ton instance Yourls ?
- 01
Installer Yourls sur ton serveur
Yourls est un logiciel auto-hébergé, donc la première étape se passe hors de n8n : l'instance doit tourner sur un serveur qui t'appartient avant qu'un credential puisse viser quoi que ce soit. Un credential, c'est la fiche de connexion que n8n garde de côté. Dès que ton instance répond sur son domaine, note cette adresse : n8n va te la demander telle quelle un peu plus loin.
- 02
Récupérer le jeton Signature
Dans l'administration Yourls, ouvre Tools, puis Secure passwordless API call. La page affiche un jeton Signature, la chaîne que n8n envoie à la place d'un mot de passe. Copie-la depuis cet écran. Le jeton appartient au compte qui l'a généré : crée-le donc depuis l'utilisateur au nom duquel tes automatisations doivent agir.
- 03
Créer le credential dans n8n
Dans n8n, va dans le menu Credentials et ajoute un credential Yourls de type clé API. Il demande deux choses : le jeton Signature que tu viens de copier et l'URL de ton instance Yourls. Un credential se crée une fois et se réutilise partout : ensuite, le nœud Yourls te le propose dans une liste déroulante et tu ne recolles plus jamais le jeton.
Ce que le nœud Yourls sait faire
Le nœud Yourls expose 3 opérations sur 1 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
URL
3 opérationsExpand a URL
url.expandCe que tu vois dans n8n
Notes & cas d'usage
Reçoit un lien court et renvoie l'adresse longue qui se cache derrière, pour que la suite du workflow travaille sur la vraie destination.
Paramètres clés
- Short URL : le lien court à résoudre, collé en entier ou repris de l'item entrant avec une expression comme
{{ $json.shortUrl }}quand il vient d'un nœud précédent.
Shorten a URL
url.shortenCe que tu vois dans n8n
Notes & cas d'usage
Envoie une adresse longue à ton instance et récupère la version courte, prête à glisser dans un message, une cellule de tableur ou un corps d'email.
Paramètres clés
- URL : l'adresse longue à raccourcir, souvent une expression du type
{{ $json.url }}qui porte le lien construit plus tôt dans l'exécution. - Keyword : facultatif, dans la collection Additional Fields, à côté de Title.
- Title : facultatif, également dans Additional Fields, le titre conservé pour les URL courtes personnalisées.
Get stats for a URL
url.statsCe que tu vois dans n8n
Notes & cas d'usage
Relit ce que ton instance a enregistré pour un lien court donné : c'est par là qu'un workflow rend compte d'une campagne sans que personne n'ouvre le tableau de bord Yourls.
Paramètres clés
- Short URL : le lien court sur lequel tu veux des stats. Un appel traite un lien, donc boucle sur la liste quand une campagne en compte plusieurs.
Besoin d'aide pour automatiser Yourls avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
