Que fait umami-skill ?
Compétence pour l'agent Cursor permettant de récupérer et d'analyser le trafic d'un site web à partir d'une instance Umami auto-hébergée.
Configuration
Définissez les variables d'environnement suivantes dans votre projet ou votre profil utilisateur :
export UMAMI_URL="https://umami.votredomaine.com"
export UMAMI_TOKEN="votre_token_api"
export UMAMI_SITE_ID="id_du_site"
Utilisation
Une fois la configuration effectuée, vous pouvez demander à l'agent d'obtenir des analyses de trafic en utilisant des invites comme :
- "Quel a été le trafic de mon site cette semaine ?"
- "Montre-moi les pages les plus consultées du mois dernier."
- "D'où proviennent mes visiteurs ?"
- "Quel est le taux de rebond actuel ?"
Fonctionnalités
- Récupération des métriques : visiteurs uniques, pages vues, taux de rebond, durée moyenne des sessions.
- Analyse des sources : trafic direct, moteurs de recherche, réseaux sociaux, références.
- Tendances temporelles : évolution quotidienne, hebdomadaire, mensuelle.
- Top pages : classement des pages les plus visitées.
- Filtres : par période (date de début, date de fin), par page, par type d'événement.
API Supportée
Compétence conçue pour Umami v1 et v2. Elle utilise l'API REST authentifiée par un token.
Exemple de sortie (JSON)
{
"pageviews": { "value": 15234, "change": 12.5 },
"uniques": { "value": 4321, "change": 8.3 },
"bounceRate": { "value": 45.2, "change": -2.1 },
"avgDuration": { "value": 185, "change": 5.4 }
}
Remarques
- Les tokens d'API Umami se génèrent depuis l'interface d'administration.
- Pour obtenir l'ID du site, utilisez l'API Umami ou regardez dans l'URL de votre tableau de bord (ex:
/websites/xxxxx).