Connecteur Matomo
Matomo est un outil d'analyse d'audience web, sous licence GPL-3.0, que l'on peut héberger soi-même. Le connecteur interroge son API de rapports. Il est en lecture seule.
Mesuré le 2026-10-03 dans connectors/matomo.yaml : 113 outils, tous en méthode GET.
Pourquoi seulement de la lecture
L'API de Matomo modifie des données par des requêtes GET. Une passe de correction du 2026-06-25, consignée dans le fichier, a donc retiré 29 outils de mutation (création et modification d'objectifs, de sites, d'utilisateurs, de segments, d'alertes, anonymisation, suppression de données de personnes). Il reste 113 méthodes de rapport. generate_report et export_data_subjects sont conservés : ils renvoient des données.
Ce que déclare le fichier
| Propriété | Valeur |
|---|---|
| Fichier | connectors/matomo.yaml |
| Protocole | API de rapports, chemin unique /index.php |
| Authentification | jeton token_auth passé en paramètre de requête, lu dans MATOMO_API_KEY |
| Adresse de l'instance | variable MATOMO_URL |
| Licence déclarée | GPL-3.0 |
| Résidence déclarée | auto-hébergé |
Le jeton voyage dans l'URL de la requête, parce que Matomo n'accepte pas d'en-tête d'authentification pour cette API (explication consignée dans le fichier). Gardez-le hors de tout journal d'accès que vous ne maîtrisez pas.
Outils
Les noms n'ont pas de préfixe de connecteur. Chaque outil prend en paramètres idSite (entier), period et date. Il n'existe pas de variable MATOMO_SITE_ID : le site se choisit à chaque appel.
Exemples réels :
| Besoin | Outils |
|---|---|
| Visites | get_visits_summary, get_visits, get_unique_visitors, get_actions, get_bounce_count |
| Pages | get_page_urls, get_page_titles, get_entry_page_urls, get_exit_page_urls |
| Sources de trafic | get_referrer_type, get_all_referrers, get_keywords, get_search_engines, get_socials |
| Objectifs et conversions | get_goals, get_goal, get_conversions |
| Audience | get_country, get_city, get_device_type, get_browsers, get_os_families |
| Détail des visites | get_last_visits_details, get_visitor_profile, get_counters |
| Données personnelles | export_data_subjects |
Il n'existe pas d'outil nommé get_live_visitors. Les visites récentes se lisent avec get_last_visits_details.
Configuration
| Variable | Rôle |
|---|---|
MATOMO_URL | Adresse de l'instance Matomo |
MATOMO_API_KEY | Jeton d'authentification de l'API |
Dans l'application : page Identifiants (/credentials), fiche Matomo Analytics, champs « URL du serveur », « Site ID » et « API Token » (ce dernier alimente MATOMO_API_KEY). Le champ « Site ID » est demandé par le formulaire, mais le connecteur ne le lit pas : indiquez le site (idSite) à chaque appel.
Les variables MATOMO_TOKEN et MATOMO_SITE_ID ne sont lues par aucun connecteur.
Déploiement
podman-compose.vps2.yml déploie Matomo (image officielle épinglée) avec une base MariaDB dédiée. L'entrée du catalogue métier a le statut available.
Exemple
Combien de visiteurs uniques sur le site 1 la semaine dernière ?
L'agent choisit get_unique_visitors avec idSite, period et date.
Fichier source
Le connecteur est déclaré dans connectors/matomo.yaml.
Voir aussi
- Vue d'ensemble : chiffres mesurés, chargement et règles communes aux douze connecteurs
- Créer votre premier connecteur MCP : forme d'un fichier YAML et ajout d'un connecteur à la passerelle
- Routes MCP : ouvrir une session et appeler un outil par JSON-RPC
- Tarification : nombre de connecteurs métier inclus dans chaque offre
- RGPD : droits des personnes, en regard de l'outil d'export des données