| name | url-shortener |
| description | Raccourcir des URLs via is.gd ou v.gd. Use when: l'utilisateur demande de raccourcir une URL, créer un lien court, ou simplifier une URL longue. NOT for: URLs nécessitant une authentification, liens personnalisés avec domaine propre, analytics avancés. |
| metadata | {"openclaw":{"emoji":"🔗","requires":{"bins":["curl","python3"]}}} |
URL Shortener Skill
Raccourcir des URLs rapidement via des services gratuits.
Quand l'utiliser
✅ USE ce skill quand:
- "Raccourcis cette URL"
- "Crée un lien court pour..."
- "Simplifie ce lien"
- L'utilisateur fournit une URL longue à raccourcir
❌ N'utilisez PAS ce skill pour:
- URLs nécessitant une authentification
- Liens personnalisés avec domaine propre
- Analytics avancés des clics
- URLs internes/privées
Services disponibles
is.gd (recommandé)
Service gratuit, fiable et sans publicité.
curl -s "https://is.gd/create.php?format=simple&url=https://example.com/very/long/url"
curl -s "https://is.gd/create.php?format=simple&url=$(python3 -c 'import urllib.parse; print(urllib.parse.quote("https://example.com/long url with spaces"))')"
v.gd (alternative)
Même service que is.gd avec un domaine différent.
curl -s "https://v.gd/create.php?format=simple&url=https://example.com"
Utilisation du script Python
Pour une utilisation plus robuste avec gestion d'erreurs:
python3 {baseDir}/shorten.py "https://example.com/very/long/url/to/shorten"
Le script gère automatiquement:
- L'encodage de l'URL
- Les erreurs réseau
- Le fallback entre services
Exemples d'utilisation
Exemple 1: URL simple
Demande: "Raccourcis https://github.com/openclaw/openclaw"
Commande:
curl -s "https://is.gd/create.php?format=simple&url=https://github.com/openclaw/openclaw"
Réponse: https://is.gd/openclaw
Exemple 2: URL avec espaces
Demande: "Raccourcis https://example.com/path with spaces"
Commande:
python3 {baseDir}/shorten.py "https://example.com/path with spaces"
Exemple 3: Via le script
Demande: "Crée un lien court pour mon site"
Action: Demander l'URL, puis:
python3 {baseDir}/shorten.py "<url_fournie>"
Format de sortie
| Format | Description | Exemple |
|---|
format=simple | Retourne uniquement l'URL raccourcie | https://is.gd/abc123 |
format=json | Retourne un JSON avec métadonnées | {"shorturl": "...", "err": ""} |
Workflow typique
- Recevoir l'URL à raccourcir
- Encoder l'URL si nécessaire
- Appeler l'API is.gd ou v.gd
- Retourner l'URL raccourcie à l'utilisateur
Notes importantes
- Pas de clé API requise - Service gratuit
- Rate limiting - Soyez raisonnable dans l'utilisation
- Les liens n'expirent pas - Les URLs raccourcies sont permanentes
- Pas de personnalisation - Le suffixe est généré automatiquement
Gestion des erreurs
| Erreur | Cause | Solution |
|---|
Error: Invalid URL | URL malformée | Vérifier le format de l'URL |
Error: Blocked domain | Domaine bloqué par le service | Essayer un autre service |
Connection error | Problème réseau | Réessayer plus tard |
Script intégré
Le script shorten.py fournit une interface robuste:
python3 {baseDir}/shorten.py "https://example.com"
python3 {baseDir}/shorten.py --service vgd "https://example.com"
python3 {baseDir}/shorten.py --verbose "https://example.com"